@matimo/gmail 0.1.0-alpha.8 → 0.1.0

package/README.md

@@ -216,7 +216,7 @@ parameters:
     required: false # Optional
     example: 'cc@example.com'
 
-  is_html:
+  isHtml:
     type: boolean
     required: false
     default: false
@@ -269,7 +269,7 @@ execution:
 
 ```yaml
 parameter_encoding:
-  - source: [to, subject, body, cc, bcc, is_html]
+  - source: [to, subject, body, cc, bcc, isHtml]
     target: raw
     encoding: mime_rfc2822_base64url # Convert to MIME format
 ```
@@ -657,10 +657,10 @@ pnpm run gmail:factory --email:youremail@gmail.com
 | Tool                   | Purpose                | Input                                | Output                     |
 | ---------------------- | ---------------------- | ------------------------------------ | -------------------------- |
 | `gmail-list-messages`  | List emails from inbox | `maxResults`, `query`, `labelIds`    | `messages[]`               |
-| `gmail-get-message`    | Get full email details | `message_id`, `format`               | `id`, `payload`, `headers` |
+| `gmail-get-message`    | Get full email details | `messageId`, `format`               | `id`, `payload`, `headers` |
 | `gmail-send-email`     | Send email             | `to`, `subject`, `body`, `cc`, `bcc` | `id`                       |
 | `gmail-create-draft`   | Create draft email     | `to`, `subject`, `body`, `cc`, `bcc` | `id`                       |
-| `gmail-delete-message` | Delete email           | `message_id`                         | `success`                  |
+| `gmail-delete-message` | Delete email           | `messageId`                         | `success`                  |
 
 ### Tool Reference
 
@@ -723,7 +723,7 @@ const result = await matimo.execute('gmail-list-messages', {
   body: string;                // Required: Email body
   cc?: string;                 // Optional: CC recipient(s)
   bcc?: string;                // Optional: BCC recipient(s)
-  is_html?: boolean;           // Optional: HTML body (default: false)
+  isHtml?: boolean;           // Optional: HTML body (default: false)
 }
 ```
 
@@ -751,7 +751,7 @@ const result = await matimo.execute('gmail-send-email', {
   to: 'user@example.com',
   subject: 'Hello from Matimo',
   body: 'This email was sent via Gmail tools!',
-  is_html: false,
+  isHtml: false,
 });
 ```
 
@@ -770,7 +770,7 @@ const result = await matimo.execute('gmail-send-email', {
   body: string;                // Required: Draft body
   cc?: string;                 // Optional: CC recipient(s)
   bcc?: string;                // Optional: BCC recipient(s)
-  is_html?: boolean;           // Optional: HTML body (default: false)
+  isHtml?: boolean;           // Optional: HTML body (default: false)
 }
 ```
 
@@ -796,7 +796,7 @@ const result = await matimo.execute('gmail-create-draft', {
   to: 'user@example.com',
   subject: 'Weekly Summary',
   body: 'Generated by AI agent...',
-  is_html: true,
+  isHtml: true,
 });
 // User can manually review and send from Gmail
 ```
@@ -811,7 +811,7 @@ const result = await matimo.execute('gmail-create-draft', {
 
 ```typescript
 {
-  message_id: string;          // Required: Email ID (from list-messages)
+  messageId: string;          // Required: Email ID (from list-messages)
   format?: string;             // Optional: "minimal" | "full" | "raw"
                                // Default: "full"
 }
@@ -844,7 +844,7 @@ const result = await matimo.execute('gmail-create-draft', {
 
 ```typescript
 const result = await matimo.execute('gmail-get-message', {
-  message_id: '18b8f4a2a1c5e3d2',
+  messageId: '18b8f4a2a1c5e3d2',
   format: 'full',
 });
 ```
@@ -859,7 +859,7 @@ const result = await matimo.execute('gmail-get-message', {
 
 ```typescript
 {
-  message_id: string; // Required: Email ID to delete
+  messageId: string; // Required: Email ID to delete
 }
 ```
 
@@ -868,7 +868,7 @@ const result = await matimo.execute('gmail-get-message', {
 ```typescript
 {
   success: boolean;
-  message_id: string;
+  messageId: string;
 }
 ```
 
@@ -876,7 +876,7 @@ const result = await matimo.execute('gmail-get-message', {
 
 ```typescript
 const result = await matimo.execute('gmail-delete-message', {
-  message_id: '18b8f4a2a1c5e3d2',
+  messageId: '18b8f4a2a1c5e3d2',
 });
 ```
 
@@ -1029,7 +1029,7 @@ await matimo.execute('gmail-send-email', {
     <p>This is an <strong>HTML</strong> email.</p>
     <a href="https://example.com">Click here</a>
   `,
-  is_html: true, // Enable HTML parsing
+  isHtml: true, // Enable HTML parsing
 });
 ```
 
@@ -1084,7 +1084,7 @@ await matimo.execute('gmail-send-email', {
 
 ```yaml
 parameter_encoding:
-  - source: [to, subject, body, cc, bcc, is_html]
+  - source: [to, subject, body, cc, bcc, isHtml]
     target: raw
     encoding: mime_rfc2822_base64url # Handles all the above
 ```
@@ -1211,7 +1211,7 @@ Sends an email via Gmail API.
 - `body` (required): Email body (plain text or HTML)
 - `cc` (optional): CC recipients
 - `bcc` (optional): BCC recipients
-- `is_html` (optional): Treat body as HTML (default: false)
+- `isHtml` (optional): Treat body as HTML (default: false)
 - `GMAIL_ACCESS_TOKEN` (required): OAuth access token
 
 **Response:**
@@ -1252,7 +1252,7 @@ Gets a specific message with full details.
 
 **Parameters:**
 
-- `message_id` (required): Message ID to retrieve
+- `messageId` (required): Message ID to retrieve
 - `format` (optional): Response format ("minimal" | "full" | "raw")
 - `GMAIL_ACCESS_TOKEN` (required): OAuth access token
 
@@ -1279,7 +1279,7 @@ Creates a draft email.
 - `body` (required): Draft body
 - `cc` (optional): CC recipients
 - `bcc` (optional): BCC recipients
-- `is_html` (optional): Treat body as HTML
+- `isHtml` (optional): Treat body as HTML
 - `GMAIL_ACCESS_TOKEN` (required): OAuth access token
 
 **Response:**
@@ -1296,7 +1296,7 @@ Permanently deletes a message.
 
 **Parameters:**
 
-- `message_id` (required): Message ID to delete
+- `messageId` (required): Message ID to delete
 - `GMAIL_ACCESS_TOKEN` (required): OAuth access token
 
 **Response:**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matimo/gmail",
-  "version": "0.1.0-alpha.8",
+  "version": "0.1.0",
   "description": "Gmail tools for Matimo",
   "type": "module",
   "files": [
@@ -9,10 +9,10 @@
     "definition.yaml"
   ],
   "peerDependencies": {
-    "matimo": "0.1.0-alpha.8"
+    "matimo": "0.1.0-alpha.14"
   },
   "devDependencies": {
-    "axios": "^1.13.4",
-    "@matimo/core": "0.1.0-alpha.8"
+    "axios": "^1.15.2",
+    "@matimo/core": "0.1.0"
   }
 }

package/tools/create-draft/definition.yaml

@@ -33,7 +33,7 @@ parameters:
     required: false
     example: 'bcc@example.com'
 
-  is_html:
+  isHtml:
     type: boolean
     description: Whether the body content is HTML (default is plain text)
     required: false
@@ -55,7 +55,7 @@ execution:
 
   # Parameter encoding: automatically convert to/subject/body to MIME format
   parameter_encoding:
-    - source: [to, subject, body, cc, bcc, is_html]
+    - source: [to, subject, body, cc, bcc, isHtml]
       target: raw
       encoding: mime_rfc2822_base64url
 

package/tools/delete-message/definition.yaml

@@ -3,7 +3,7 @@ description: Permanently delete a message from Gmail (cannot be undone)
 version: '1.0.0'
 
 parameters:
-  message_id:
+  messageId:
     type: string
     description: ID of the message to delete
     required: true
@@ -12,7 +12,7 @@ parameters:
 execution:
   type: http
   method: DELETE
-  url: 'https://www.googleapis.com/gmail/v1/users/me/messages/{message_id}'
+  url: 'https://www.googleapis.com/gmail/v1/users/me/messages/{messageId}'
   headers:
     Authorization: 'Bearer {GMAIL_ACCESS_TOKEN}'
   note: 'Immediately and permanently deletes the message. This operation cannot be undone. Use trash instead if you want to allow recovery.'
@@ -25,11 +25,7 @@ authentication:
 
 output_schema:
   type: object
-  description: Empty response on successful deletion (204 No Content)
-  properties:
-    success:
-      type: boolean
-      description: Whether the message was successfully deleted
+  description: Empty response on successful deletion (204 No Content). The executor may return an empty body for 204 responses.
 
 error_handling:
   retry: 3

package/tools/get-message/definition.yaml

@@ -3,7 +3,7 @@ description: Get full details of a specific Gmail message including headers and
 version: '1.0.0'
 
 parameters:
-  message_id:
+  messageId:
     type: string
     description: ID of the message to retrieve
     required: true
@@ -20,7 +20,7 @@ parameters:
     default: full
     example: full
 
-  metadata_headers:
+  metadataHeaders:
     type: string
     description: Comma-separated headers to include in metadata (when format=minimal)
     required: false
@@ -29,7 +29,10 @@ parameters:
 execution:
   type: http
   method: GET
-  url: 'https://www.googleapis.com/gmail/v1/users/me/messages/{message_id}?format={format}&metadataHeaders={metadata_headers}'
+  url: 'https://www.googleapis.com/gmail/v1/users/me/messages/{messageId}'
+  query_params:
+    format: '{format}'
+    metadataHeaders: '{metadataHeaders}'
   headers:
     Authorization: 'Bearer {GMAIL_ACCESS_TOKEN}'
     Accept: 'application/json'
@@ -39,8 +42,6 @@ authentication:
   provider: google
   scopes:
     - 'https://www.googleapis.com/auth/gmail.readonly'
-  client_id_env: GMAIL_CLIENT_ID
-  client_secret_env: GMAIL_CLIENT_SECRET
 
 output_schema:
   type: object
@@ -48,10 +49,10 @@ output_schema:
     id:
       type: string
       description: Message ID
-    thread_id:
+    threadId:
       type: string
       description: Thread ID
-    label_ids:
+    labelIds:
       type: array
       items:
         type: string
@@ -59,7 +60,7 @@ output_schema:
     snippet:
       type: string
       description: Short snippet of the message text
-    size_estimate:
+    sizeEstimate:
       type: number
       description: Estimated size of the message in bytes
     headers:
@@ -69,7 +70,7 @@ output_schema:
       type: object
       description: Message body with data and mimeType
       properties:
-        mime_type:
+        mimeType:
           type: string
         data:
           type: string

package/tools/send-email/definition.yaml

@@ -33,7 +33,7 @@ parameters:
     required: false
     example: 'bcc@example.com'
 
-  is_html:
+  isHtml:
     type: boolean
     description: Whether the body content is HTML (default is plain text)
     required: false
@@ -55,7 +55,7 @@ execution:
 
   # Parameter encoding: automatically convert to/subject/body to MIME format
   parameter_encoding:
-    - source: [to, subject, body, cc, bcc, is_html]
+    - source: [to, subject, body, cc, bcc, isHtml]
       target: raw
       encoding: mime_rfc2822_base64url
 

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 tallclub
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.