@bradtech/sales-skills 1.0.0

package/skills/vendor/brevo/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: brevo-integration
+description: >-
+  Allows querying and updating your Brevo account, and syncing/enriching contacts between Odoo and Brevo.
+  Trigger when the user wants to list contacts in Brevo, create/update a contact on Brevo,
+  or synchronize/enrich contact records between Odoo and Brevo.
+---
+
+# Brevo Integration & Odoo Sync Skill
+
+## Presentation
+This Skill provides a CLI tool executed via Bun to interact with Brevo via its official API v3, along with an orchestration workflow to bidirectionally sync and enrich contact details between Odoo CRM and Brevo.
+
+## Prerequisites and Credentials
+The CLI automatically loads parameters from your `.env` file at the root of the sales-skills repository:
+- Expected path: `/Users/crapougnax/CODE/BRAD2026/sales-skills/.env`
+
+Please configure your Brevo v3 API key:
+```env
+BREVO_API_KEY="your_brevo_api_key_v3"
+```
+
+## Quick Start / Usage
+
+All commands must be executed using `bun run`. Always redirect JSON output to `.log/` folders via the `--output` option.
+
+### 1. List Brevo Contacts
+```bash
+bun run skills/vendor/brevo/cli.ts list-contacts \
+  --limit 50 \
+  --output ".log/brevo_contacts.json"
+```
+
+### 2. Retrieve a Brevo Contact by Email
+```bash
+bun run skills/vendor/brevo/cli.ts get-contact \
+  --email "contact@acme.com" \
+  --output ".log/brevo_contact_details.json"
+```
+
+### 3. Create or Update a Brevo Contact
+```bash
+bun run skills/vendor/brevo/cli.ts create-or-update-contact \
+  --email "contact@acme.com" \
+  --firstname "Alice" \
+  --lastname "Smith" \
+  --phone "33600000000" \
+  --output ".log/brevo_update_result.json"
+```
+
+---
+
+## Bidirectional Sync & Enrichment Workflow (Odoo <-> Brevo)
+
+When requested to synchronize or enrich contacts between Odoo and Brevo, the agent performs these steps:
+
+### Step 1: Query and Extract Contacts
+Identify target contacts (either by a specific email, email domain, or listing the latest modified records).
+1. Query Odoo:
+   ```bash
+   bun run skills/vendor/odoo/cli.ts search-partners \
+     --query "<QUERY>" \
+     --limit 50 \
+     --output ".log/odoo_search.json"
+   ```
+2. Query Brevo using `get-contact` for each target email found, or list contacts.
+
+### Step 2: Data Comparison and Discrepancy Detection
+Compare attributes across Odoo and Brevo:
+- **Missing Contacts**: Exists in Odoo but not in Brevo, or vice-versa.
+- **Incomplete Fields**:
+  - Name: Exists on Brevo (`FIRSTNAME`, `LASTNAME`) but Odoo only has the raw email string.
+  - Phone: Missing on Odoo but present on Brevo (or vice-versa).
+
+### Step 3: Interactive Sync Proposal
+Present a clean markdown table showing:
+- Missing contacts on both platforms.
+- Gaps in names or phone attributes.
+- **Prompt the user for validation before applying any creation or enrichment.**
+
+### Step 4: Apply Updates
+- **Enrich Brevo**: Call `create-or-update-contact` with Odoo details.
+- **Enrich Odoo**: Call `update-partner` or `create-contact` with Brevo details.

package/skills/vendor/brevo/cli.ts

@@ -0,0 +1,167 @@
+import { CliCommand } from '@quatrain/cli';
+import { ApiClient } from '@quatrain/api-client';
+import { Skills } from '@quatrain/skills';
+
+class BrevoClient {
+  private client: ApiClient;
+  private apiKey: string;
+
+  constructor() {
+    this.apiKey = process.env.BREVO_API_KEY || '';
+    if (!this.apiKey) {
+      Skills.error(
+        'Error: The BREVO_API_KEY environment variable must be defined.\n' +
+        'Please declare it in your local `.env` file.'
+      );
+      process.exit(1);
+    }
+    
+    // Instantiate ApiClient with Brevo base URL
+    this.client = new ApiClient('https://api.brevo.com/v3');
+  }
+
+  private getHeaders() {
+    return {
+      'accept': 'application/json',
+      'content-type': 'application/json',
+      'api-key': this.apiKey
+    };
+  }
+
+  async listContacts(limit = 50, offset = 0) {
+    try {
+      const response = await this.client.get('contacts', {
+        limit,
+        offset,
+        headers: this.getHeaders()
+      });
+      return response.data;
+    } catch (err: any) {
+      Skills.error(`Brevo API error (listContacts): ${err.message}`);
+      process.exit(1);
+    }
+  }
+
+  async getContact(email: string) {
+    try {
+      const encodedEmail = encodeURIComponent(email);
+      const response = await this.client.get(`contacts/${encodedEmail}`, {
+        headers: this.getHeaders()
+      });
+      return response.data;
+    } catch (err: any) {
+      if (err.message.includes('404')) {
+        return null;
+      }
+      Skills.error(`Brevo API error (getContact): ${err.message}`);
+      process.exit(1);
+    }
+  }
+
+  async createOrUpdateContact(
+    email: string,
+    firstname?: string,
+    lastname?: string,
+    phone?: string,
+    customAttributes?: any
+  ) {
+    const attributes: any = {};
+    if (firstname) attributes.FIRSTNAME = firstname;
+    if (lastname) attributes.LASTNAME = lastname;
+    if (phone) attributes.SMS = phone;
+    if (customAttributes) {
+      Object.assign(attributes, customAttributes);
+    }
+
+    const payload: any = {
+      email,
+      updateEnabled: true
+    };
+    if (Object.keys(attributes).length > 0) {
+      payload.attributes = attributes;
+    }
+
+    try {
+      await this.client.post('contacts', payload);
+      return { status: 'success', email, action: 'created_or_updated' };
+    } catch (err: any) {
+      Skills.error(`Brevo API error (createOrUpdateContact): ${err.message}`);
+      process.exit(1);
+    }
+  }
+}
+
+async function main() {
+  const program = new CliCommand();
+  program
+    .name('brevo_cli')
+    .description('CLI to interact with Brevo API v3');
+
+  // Command: list-contacts
+  program
+    .command('list-contacts')
+    .description('List Brevo contacts')
+    .option('--limit <number>', 'Number of records to retrieve', (val) => parseInt(val, 10), 50)
+    .option('--offset <number>', 'Pagination offset', (val) => parseInt(val, 10), 0)
+    .requiredOption('--output <path>', 'Output JSON file path')
+    .action(async (options) => {
+      const client = new BrevoClient();
+      const result = await client.listContacts(options.limit, options.offset);
+      await Skills.writeOutput(result, options.output);
+    });
+
+  // Command: get-contact
+  program
+    .command('get-contact')
+    .description('Get contact details by email')
+    .requiredOption('--email <email>', 'Contact email address')
+    .requiredOption('--output <path>', 'Output JSON file path')
+    .action(async (options) => {
+      const client = new BrevoClient();
+      let result = await client.getContact(options.email);
+      if (result === null) {
+        result = { error: 'contact_not_found', email: options.email };
+      }
+      await Skills.writeOutput(result, options.output);
+    });
+
+  // Command: create-or-update-contact
+  program
+    .command('create-or-update-contact')
+    .description('Create or update a Brevo contact')
+    .requiredOption('--email <email>', 'Contact email address')
+    .option('--firstname <name>', 'Contact first name')
+    .option('--lastname <name>', 'Contact last name')
+    .option('--phone <sms>', 'SMS phone number attribute')
+    .option('--attributes <json-string>', 'JSON string representing additional custom attributes')
+    .requiredOption('--output <path>', 'Output JSON file path')
+    .action(async (options) => {
+      const client = new BrevoClient();
+      let customAttrs = null;
+      if (options.attributes) {
+        try {
+          customAttrs = JSON.parse(options.attributes);
+        } catch (err: any) {
+          Skills.error(`Error parsing attributes JSON: ${err.message}`);
+          process.exit(1);
+        }
+      }
+      const result = await client.createOrUpdateContact(
+        options.email,
+        options.firstname,
+        options.lastname,
+        options.phone,
+        customAttrs
+      );
+      await Skills.writeOutput(result, options.output);
+    });
+
+  await program.parseAsync(process.argv);
+}
+
+if (import.meta.main) {
+  main().catch((err) => {
+    Skills.error(`Unexpected process error: ${err.message}`);
+    process.exit(1);
+  });
+}

package/skills/vendor/google/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: google-calendar
+description: >-
+  Allows interacting with your Google Calendar to read, create, or delete events.
+  Trigger when the user asks to view upcoming meetings, schedule a new meeting, or cancel an event.
+---
+
+# Google Calendar Integration Skill
+
+## Presentation
+This Skill provides a CLI tool executed via Bun to interact with Google Calendar via the official API using a Google Cloud Service Account. It allows managing business meetings, leads follow-ups, and calendar events.
+
+## Prerequisites and Authentication
+The script requires a Google Cloud Service Account key file saved at the root of the sales-skills repository:
+- Expected path: `/Users/crapougnax/CODE/BRAD2026/sales-skills/service_account.json`
+
+**Critical Configuration Steps:**
+1. **Enable Google Calendar API**: Ensure the API is enabled on your GCP Console. You can activate it by visiting [Google Calendar API Console](https://console.developers.google.com/apis/api/calendar-json.googleapis.com/overview).
+2. **Share Your Calendar**: Share the target calendar with the service account email (ending in `@...iam.gserviceaccount.com`) in the Google Calendar web settings, granting *"Make changes to events"* permissions.
+3. **External Sharing Restrictions (Google Workspace)**: If options are grayed out, your administrator must allow external calendar management in `admin.google.com` under *Apps > Google Workspace > Calendar > Sharing Settings > External sharing options*.
+
+## Quick Start / Usage
+
+All commands must be executed using `bun run`. Always redirect JSON output to `.log/` folders via the `--output` option.
+
+### 1. List Calendar Events
+```bash
+bun run skills/vendor/google/cli.ts list-events \
+  --calendar-id "your_email@gmail.com" \
+  --limit 10 \
+  --output ".log/events_list.json"
+```
+
+**List events for a specific date range:**
+```bash
+bun run skills/vendor/google/cli.ts list-events \
+  --calendar-id "your_email@gmail.com" \
+  --time-min "2026-06-17T00:00:00Z" \
+  --time-max "2026-06-17T23:59:59Z" \
+  --limit 50 \
+  --output ".log/past_events.json"
+```
+
+### 2. Create a Calendar Event
+```bash
+bun run skills/vendor/google/cli.ts create-event \
+  --calendar-id "your_email@gmail.com" \
+  --summary "Technical Review Meeting" \
+  --start "2026-06-25 14:00:00" \
+  --duration 1.5 \
+  --description "Project architecture walkthrough" \
+  --output ".log/event_created.json"
+```
+
+### 3. Delete a Calendar Event
+```bash
+bun run skills/vendor/google/cli.ts delete-event \
+  --calendar-id "your_email@gmail.com" \
+  --event-id "calendar_event_id_to_delete" \
+  --output ".log/event_deleted.json"
+```
+
+## Common Issues & Gotchas
+1. **Unactivated API**: If you receive a "Precondition check failed" or 403 error, verify that the Google Calendar API is activated in GCP console.
+2. **Missing Permissions**: If you get a 404 or authorization error, confirm the Service Account email is added to the Google Calendar sharing list.
+3. **Date/Time format**: Ensure the start date uses the format `YYYY-MM-DD HH:MM:SS`.

package/skills/vendor/google/calendar.ts

@@ -0,0 +1,150 @@
+import { google } from 'googleapis';
+import { Skills } from '@quatrain/skills';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+const SCOPES = ['https://www.googleapis.com/auth/calendar'];
+
+function findServiceAccountFile(): string | null {
+  if (process.env.GOOGLE_APPLICATION_CREDENTIALS) {
+    if (existsSync(process.env.GOOGLE_APPLICATION_CREDENTIALS)) {
+      return process.env.GOOGLE_APPLICATION_CREDENTIALS;
+    }
+    Skills.warn(`Warning: GOOGLE_APPLICATION_CREDENTIALS env var is set to '${process.env.GOOGLE_APPLICATION_CREDENTIALS}', but the file does not exist.`);
+  }
+
+  const currentDir = process.cwd();
+  const scriptDir = import.meta.dir;
+  
+  const possiblePaths = [
+    join(currentDir, 'service_account.json'),
+    join(scriptDir, '..', '..', 'service_account.json'), // skills/vendor/google/../../service_account.json
+    join(scriptDir, '..', '..', '..', 'service_account.json'),
+  ];
+
+  for (const path of possiblePaths) {
+    if (existsSync(path)) {
+      return path;
+    }
+  }
+  return null;
+}
+
+export class GoogleCalendarClient {
+  private calendar: any;
+
+  constructor() {
+    const keyFile = findServiceAccountFile();
+    if (!keyFile) {
+      Skills.error(
+        "Error: The Google Service Account key credentials file is missing.\n" +
+        "Please place 'service_account.json' at the root of your repository, or specify its path " +
+        "using the 'GOOGLE_APPLICATION_CREDENTIALS' environment variable."
+      );
+      process.exit(1);
+    }
+
+    try {
+      const auth = new google.auth.GoogleAuth({
+        keyFile,
+        scopes: SCOPES,
+      });
+      this.calendar = google.calendar({ version: 'v3', auth });
+    } catch (err: any) {
+      Skills.error(`Error initializing Google Calendar API: ${err.message}`);
+      process.exit(1);
+    }
+  }
+
+  async listEvents(calendarId = 'primary', limit = 10, timeMin?: string, timeMax?: string) {
+    try {
+      const params: any = {
+        calendarId,
+        maxResults: limit,
+        singleEvents: true,
+        orderBy: 'startTime',
+      };
+
+      if (timeMin) {
+        params.timeMin = timeMin;
+      } else {
+        params.timeMin = new Date().toISOString();
+      }
+
+      if (timeMax) {
+        params.timeMax = timeMax;
+      }
+
+      const response = await this.calendar.events.list(params);
+      return response.data.items || [];
+    } catch (err: any) {
+      Skills.error(`Google Calendar API error (listEvents): ${err.message}`);
+      process.exit(1);
+    }
+  }
+
+  async createEvent(
+    summary: string,
+    startTimeStr: string,
+    durationHours = 1.0,
+    description?: string,
+    calendarId = 'primary'
+  ) {
+    try {
+      const normalizedStartStr = startTimeStr.replace(' ', 'T');
+      const startDt = new Date(normalizedStartStr);
+      if (isNaN(startDt.getTime())) {
+        throw new Error(`Invalid start date format: ${startTimeStr}`);
+      }
+
+      const endDt = new Date(startDt.getTime() + durationHours * 60 * 60 * 1000);
+      const timeZone = startTimeStr.endsWith('Z') ? 'UTC' : 'Europe/Paris';
+
+      const eventBody: any = {
+        summary,
+        start: {
+          dateTime: startDt.toISOString(),
+          timeZone,
+        },
+        end: {
+          dateTime: endDt.toISOString(),
+          timeZone,
+        },
+      };
+
+      if (description) {
+        eventBody.description = description;
+      }
+
+      const response = await this.calendar.events.insert({
+        calendarId,
+        requestBody: eventBody,
+      });
+
+      const event = response.data;
+      return {
+        id: event.id,
+        summary: event.summary,
+        htmlLink: event.htmlLink,
+        start: event.start?.dateTime,
+        end: event.end?.dateTime,
+      };
+    } catch (err: any) {
+      Skills.error(`Google Calendar API error (createEvent): ${err.message}`);
+      process.exit(1);
+    }
+  }
+
+  async deleteEvent(eventId: string, calendarId = 'primary') {
+    try {
+      await this.calendar.events.delete({
+        calendarId,
+        eventId,
+      });
+      return { id: eventId, status: 'deleted' };
+    } catch (err: any) {
+      Skills.error(`Google Calendar API error (deleteEvent): ${err.message}`);
+      process.exit(1);
+    }
+  }
+}

package/skills/vendor/google/cli.ts

@@ -0,0 +1,74 @@
+import { CliCommand } from '@quatrain/cli';
+import { Skills } from '@quatrain/skills';
+import { GoogleCalendarClient } from './calendar';
+
+async function main() {
+  const program = new CliCommand();
+  program
+    .name('google_cli')
+    .description('CLI to interact with Google APIs using Service Account');
+
+  // Subcommand: list-events
+  program
+    .command('list-events')
+    .description('List upcoming calendar events')
+    .option('--calendar-id <id>', 'Calendar ID (email or primary)', 'primary')
+    .requiredOption('--limit <number>', 'Maximum number of events to list', (val) => parseInt(val, 10))
+    .option('--time-min <iso-date>', 'Start date ISO-8601 string')
+    .option('--time-max <iso-date>', 'End date ISO-8601 string')
+    .requiredOption('--output <path>', 'Output JSON file path')
+    .action(async (options) => {
+      const client = new GoogleCalendarClient();
+      const result = await client.listEvents(
+        options.calendarId,
+        options.limit,
+        options.timeMin,
+        options.timeMax
+      );
+      await Skills.writeOutput(result, options.output);
+    });
+
+  // Subcommand: create-event
+  program
+    .command('create-event')
+    .description('Create a new calendar event')
+    .requiredOption('--summary <title>', 'Event title')
+    .requiredOption('--start <datetime>', 'Event start date/time (YYYY-MM-DD HH:MM:SS)')
+    .option('--duration <hours>', 'Duration of the event in hours', (val) => parseFloat(val), 1.0)
+    .option('--description <text>', 'Event description')
+    .option('--calendar-id <id>', 'Calendar ID (email or primary)', 'primary')
+    .requiredOption('--output <path>', 'Output JSON file path')
+    .action(async (options) => {
+      const client = new GoogleCalendarClient();
+      const result = await client.createEvent(
+        options.summary,
+        options.start,
+        options.duration,
+        options.description,
+        options.calendarId
+      );
+      await Skills.writeOutput(result, options.output);
+    });
+
+  // Subcommand: delete-event
+  program
+    .command('delete-event')
+    .description('Delete a calendar event by ID')
+    .requiredOption('--event-id <id>', 'Event ID')
+    .option('--calendar-id <id>', 'Calendar ID (email or primary)', 'primary')
+    .requiredOption('--output <path>', 'Output JSON file path')
+    .action(async (options) => {
+      const client = new GoogleCalendarClient();
+      const result = await client.deleteEvent(options.eventId, options.calendarId);
+      await Skills.writeOutput(result, options.output);
+    });
+
+  await program.parseAsync(process.argv);
+}
+
+if (import.meta.main) {
+  main().catch((err) => {
+    Skills.error(`Unexpected process error: ${err.message}`);
+    process.exit(1);
+  });
+}

package/skills/vendor/odoo/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: odoo-integration
+description: >-
+  Allows interacting with your Odoo ERP to create or view entities such as
+  companies, individual contacts, business opportunities (leads/CRM), calendar appointments, and planned activities.
+  Trigger when the user wants to add/update clients, record sales opportunities, schedule Odoo meetings, or search active records.
+---
+
+# Odoo Integration Skill
+
+## Presentation
+This Skill provides a CLI tool executed via Bun to interact with Odoo ERP via its official XML-RPC API. It enables structuring client accounts by creating companies, linking contacts to those companies, logging CRM opportunities, calendar appointments, and scheduled follow-up activities.
+
+## Prerequisites and Credentials
+The CLI automatically loads parameters from your `.env` file at the root of the sales-skills repository:
+- Expected path: `/Users/crapougnax/CODE/BRAD2026/sales-skills/.env`
+
+Please configure the following environment variables:
+- `ODOO_URL`: URL of your Odoo instance (e.g. `https://your-erp.odoo.com`)
+- `ODOO_DB`: Database name
+- `ODOO_USER`: Connection email or login username
+- `ODOO_PASSWORD`: Generated API Key from your Odoo user profile (recommended) or connection password
+
+## Quick Start / Usage
+
+All commands must be executed using `bun run`. Always redirect JSON output to `.log/` folders via the `--output` option.
+
+### 1. Create a Company
+```bash
+bun run skills/vendor/odoo/cli.ts create-company \
+  --name "Acme Corporation" \
+  --email "billing@acme.com" \
+  --phone "+33102030405" \
+  --city "Paris" \
+  --country "France" \
+  --street "123 Main Street" \
+  --output ".log/company_result.json"
+```
+
+### 2. Create a Contact (linked to a company)
+```bash
+bun run skills/vendor/odoo/cli.ts create-contact \
+  --name "Alice Smith" \
+  --company-id 1234 \
+  --email "alice@acme.com" \
+  --phone "+33600000000" \
+  --function "Purchasing Manager" \
+  --street "123 Main Street" \
+  --output ".log/contact_result.json"
+```
+
+### 3. Update a Partner (Company or Contact)
+```bash
+bun run skills/vendor/odoo/cli.ts update-partner \
+  --id 1234 \
+  --phone "+33611223344" \
+  --company-id 5678 \
+  --output ".log/update_result.json"
+```
+
+### 4. Create a CRM Opportunity
+```bash
+bun run skills/vendor/odoo/cli.ts create-opportunity \
+  --name "Enterprise ERP License Proposal" \
+  --partner-id 1234 \
+  --revenue 45000 \
+  --description "12-month software subscription" \
+  --output ".log/opp_result.json"
+```
+
+### 5. Create a Meeting (Calendar Event)
+```bash
+bun run skills/vendor/odoo/cli.ts create-meeting \
+  --name "Project Review" \
+  --start "2026-06-25 10:00:00" \
+  --duration 1.0 \
+  --partner-ids "1234,5678" \
+  --output ".log/meeting_result.json"
+```
+*Note: Start date must be provided in UTC format: `YYYY-MM-DD HH:MM:SS`.*
+
+### 6. Create a Planned Activity
+```bash
+bun run skills/vendor/odoo/cli.ts create-activity \
+  --model "res.partner" \
+  --res-id 1234 \
+  --summary "Send technical quote" \
+  --note "Quote detailing the scope of work" \
+  --type "todo" \
+  --output ".log/activity_result.json"
+```
+
+### 7. Search Partners
+```bash
+bun run skills/vendor/odoo/cli.ts search-partners \
+  --query "Acme" \
+  --is-company true \
+  --limit 10 \
+  --output ".log/search_partners_result.json"
+```
+
+### 8. Search CRM Opportunities
+```bash
+bun run skills/vendor/odoo/cli.ts search-opportunities \
+  --query "ERP" \
+  --limit 10 \
+  --output ".log/search_opportunities_result.json"
+```
+
+## Common Issues & Guidelines
+1. **API Credentials**: Ensure your `.env` file variables match your Odoo user profile API credentials.
+2. **Entity Ordering**: When doing a complete ingestion:
+   - Step A: Create/find the Company (to get its `id`).
+   - Step B: Create/find the Contact, linking it to the Company ID.
+   - Step C: Create the CRM Opportunity, linking it to the Contact or Company.
+3. **Automatic Stop Time**: The `create-meeting` command automatically computes the `stop` datetime to prevent validation mismatch errors.