matimo 0.1.0-alpha.3 → 0.1.0-alpha.5

package/tools/gmail/create-draft/definition.yaml

@@ -1,99 +0,0 @@
-name: gmail-create-draft
-description: Create a draft email in Gmail without sending it
-version: '1.0.0'
-
-parameters:
-  to:
-    type: string
-    description: Email address of the recipient(s), comma-separated for multiple recipients
-    required: true
-    example: 'user@example.com'
-
-  subject:
-    type: string
-    description: Subject line of the draft email
-    required: true
-    example: 'Draft Email'
-
-  body:
-    type: string
-    description: Email body content (plain text or HTML)
-    required: true
-    example: 'This is a draft email'
-
-  cc:
-    type: string
-    description: CC email addresses, comma-separated
-    required: false
-    example: 'cc@example.com'
-
-  bcc:
-    type: string
-    description: BCC email addresses, comma-separated
-    required: false
-    example: 'bcc@example.com'
-
-  is_html:
-    type: boolean
-    description: Whether the body content is HTML (default is plain text)
-    required: false
-    default: false
-
-  raw:
-    type: string
-    description: 'Base64url-encoded MIME message (RFC 2822 format). If provided, overrides to/subject/body/cc/bcc parameters.'
-    required: false
-    example: 'VG8...'
-
-execution:
-  type: http
-  method: POST
-  url: 'https://www.googleapis.com/gmail/v1/users/me/drafts'
-  headers:
-    Content-Type: 'application/json'
-    Authorization: 'Bearer {GMAIL_ACCESS_TOKEN}'
-  
-  # Parameter encoding: automatically convert to/subject/body to MIME format
-  parameter_encoding:
-    - source: [to, subject, body, cc, bcc, is_html]
-      target: raw
-      encoding: mime_rfc2822_base64url
-  
-  body:
-    message:
-      raw: '{raw}'
-
-authentication:
-  type: oauth2
-  provider: google
-  scopes:
-    - 'https://www.googleapis.com/auth/gmail.compose'
-
-output_schema:
-  type: object
-  properties:
-    id:
-      type: string
-      description: Draft ID
-    message:
-      type: object
-      description: The created message object
-      properties:
-        id:
-          type: string
-        threadId:
-          type: string
-        labelIds:
-          type: array
-          items:
-            type: string
-
-error_handling:
-  retry: 3
-  backoff_type: exponential
-  initial_delay_ms: 1000
-  retryable_status_codes:
-    - 429
-    - 500
-    - 502
-    - 503

package/tools/gmail/definition.yaml

@@ -1,49 +0,0 @@
-# Google OAuth2 Provider Definition
-#
-# This file defines the OAuth2 configuration for Google.
-# All Gmail tools reference this provider definition.
-#
-# Users can override these endpoints via:
-# 1. Runtime config (highest priority)
-# 2. Environment variables: OAUTH_GOOGLE_AUTH_URL, OAUTH_GOOGLE_TOKEN_URL, etc.
-# 3. This YAML definition (lowest priority)
-#
-# Pattern: Define once, use everywhere
-
-name: google-provider
-type: provider
-version: '1.0.0'
-
-description: |
-  Google OAuth2 Provider Configuration
-  
-  All Gmail tools and Google-dependent tools use these endpoints.
-  
-  Setup:
-  1. Create Google Cloud project
-  2. Enable Gmail API
-  3. Create OAuth2 credentials (web application)
-  4. Set GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET environment variables
-  5. Set GOOGLE_REDIRECT_URI to your callback URL
-
-provider:
-  name: google
-  displayName: Google
-  
-  # OAuth2 Endpoints
-  # Standard Google OAuth2 endpoints - change only if using custom proxy
-  endpoints:
-    authorizationUrl: https://accounts.google.com/o/oauth2/v2/auth
-    tokenUrl: https://oauth2.googleapis.com/token
-    revokeUrl: https://oauth2.googleapis.com/revoke
-  
-  # Standard scopes for Gmail access
-  # Tools can override with their own scopes
-  defaultScopes:
-    - https://www.googleapis.com/auth/gmail.readonly
-    - https://www.googleapis.com/auth/gmail.send
-    - https://www.googleapis.com/auth/gmail.compose
-  
-  # Additional metadata
-  documentation: https://developers.google.com/gmail/api
-  learnMore: https://developers.google.com/oauthplayground

package/tools/gmail/delete-message/definition.yaml

@@ -1,42 +0,0 @@
-name: gmail-delete-message
-description: Permanently delete a message from Gmail (cannot be undone)
-version: '1.0.0'
-
-parameters:
-  message_id:
-    type: string
-    description: ID of the message to delete
-    required: true
-    example: '187a65b7f3f2f11e'
-
-execution:
-  type: http
-  method: DELETE
-  url: 'https://www.googleapis.com/gmail/v1/users/me/messages/{message_id}'
-  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.'
-
-authentication:
-  type: oauth2
-  provider: google
-  scopes:
-    - 'https://www.googleapis.com/auth/gmail.modify'
-
-output_schema:
-  type: object
-  description: Empty response on successful deletion (204 No Content)
-  properties:
-    success:
-      type: boolean
-      description: Whether the message was successfully deleted
-
-error_handling:
-  retry: 3
-  backoff_type: exponential
-  initial_delay_ms: 1000
-  retryable_status_codes:
-    - 429
-    - 500
-    - 502
-    - 503

package/tools/gmail/get-message/definition.yaml

@@ -1,89 +0,0 @@
-name: gmail-get-message
-description: Get full details of a specific Gmail message including headers and body
-version: '1.0.0'
-
-parameters:
-  message_id:
-    type: string
-    description: ID of the message to retrieve
-    required: true
-    example: '187a65b7f3f2f11e'
-
-  format:
-    type: string
-    enum:
-      - minimal
-      - full
-      - raw
-    description: Format of the message to return
-    required: false
-    default: full
-    example: full
-
-  metadata_headers:
-    type: string
-    description: Comma-separated headers to include in metadata (when format=minimal)
-    required: false
-    example: 'From,Subject,Date'
-
-execution:
-  type: http
-  method: GET
-  url: 'https://www.googleapis.com/gmail/v1/users/me/messages/{message_id}?format={format}&metadataHeaders={metadata_headers}'
-  headers:
-    Authorization: 'Bearer {GMAIL_ACCESS_TOKEN}'
-    Accept: 'application/json'
-
-authentication:
-  type: oauth2
-  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
-  properties:
-    id:
-      type: string
-      description: Message ID
-    thread_id:
-      type: string
-      description: Thread ID
-    label_ids:
-      type: array
-      items:
-        type: string
-      description: Array of label IDs applied to this message
-    snippet:
-      type: string
-      description: Short snippet of the message text
-    size_estimate:
-      type: number
-      description: Estimated size of the message in bytes
-    headers:
-      type: object
-      description: Message headers (From, To, Subject, Date, etc.)
-    body:
-      type: object
-      description: Message body with data and mimeType
-      properties:
-        mime_type:
-          type: string
-        data:
-          type: string
-          description: Message body data (base64 encoded if raw format)
-    error:
-      type: string
-      description: Error message if request failed
-
-error_handling:
-  retry: 3
-  backoff_type: exponential
-  initial_delay_ms: 1000
-  retryable_status_codes:
-    - 429
-    - 500
-    - 502
-    - 503

package/tools/gmail/list-messages/definition.yaml

@@ -1,84 +0,0 @@
-name: gmail-list-messages
-description: List messages from Gmail mailbox with filtering and pagination
-version: '1.0.0'
-
-parameters:
-  query:
-    type: string
-    description: Gmail search query (e.g., 'from:user@example.com', 'subject:hello', 'is:unread')
-    required: false
-    example: 'is:unread'
-
-  maxResults:
-    type: number
-    description: Maximum number of messages to return (1-500, defaults to 100)
-    required: false
-    default: 100
-    example: 20
-
-  pageToken:
-    type: string
-    description: Page token for pagination
-    required: false
-    example: 'NEXT_PAGE_TOKEN'
-
-  includeSpamTrash:
-    type: boolean
-    description: Include spam and trash in results (defaults to false)
-    required: false
-    default: false
-
-  labelIds:
-    type: string
-    description: Comma-separated label IDs to filter by
-    required: false
-    example: 'INBOX,IMPORTANT'
-
-execution:
-  type: http
-  method: GET
-  url: 'https://www.googleapis.com/gmail/v1/users/me/messages'
-  query_params:
-    q: '{query}'
-    maxResults: '{maxResults}'
-    pageToken: '{pageToken}'
-    includeSpamTrash: '{includeSpamTrash}'
-    labelIds: '{labelIds}'
-  headers:
-    Authorization: 'Bearer {GMAIL_ACCESS_TOKEN}'
-
-authentication:
-  type: oauth2
-  provider: google
-  scopes:
-    - 'https://www.googleapis.com/auth/gmail.readonly'
-
-output_schema:
-  type: object
-  properties:
-    messages:
-      type: array
-      description: List of message objects (contains only id and threadId)
-      items:
-        type: object
-        properties:
-          id:
-            type: string
-          threadId:
-            type: string
-    nextPageToken:
-      type: string
-      description: Token for fetching next page of results
-    resultSizeEstimate:
-      type: number
-      description: Estimated total number of results
-
-error_handling:
-  retry: 3
-  backoff_type: exponential
-  initial_delay_ms: 1000
-  retryable_status_codes:
-    - 429
-    - 500
-    - 502
-    - 503

package/tools/gmail/send-email/definition.yaml

@@ -1,95 +0,0 @@
-name: gmail-send-email
-description: Send an email using Gmail API with MIME format encoding
-version: '1.0.0'
-
-parameters:
-  to:
-    type: string
-    description: Email address of the recipient(s), comma-separated for multiple recipients
-    required: true
-    example: 'user@example.com'
-
-  subject:
-    type: string
-    description: Subject line of the email
-    required: true
-    example: 'Hello from Matimo'
-
-  body:
-    type: string
-    description: Email body content (plain text or HTML)
-    required: true
-    example: 'This is a test email from Matimo'
-
-  cc:
-    type: string
-    description: CC email addresses, comma-separated
-    required: false
-    example: 'cc@example.com'
-
-  bcc:
-    type: string
-    description: BCC email addresses, comma-separated
-    required: false
-    example: 'bcc@example.com'
-
-  is_html:
-    type: boolean
-    description: Whether the body content is HTML (default is plain text)
-    required: false
-    default: false
-
-  raw:
-    type: string
-    description: 'Base64url-encoded MIME message (RFC 2822 format). If provided, overrides to/subject/body/cc/bcc parameters.'
-    required: false
-    example: 'VG8...'
-
-execution:
-  type: http
-  method: POST
-  url: 'https://www.googleapis.com/gmail/v1/users/me/messages/send'
-  headers:
-    Content-Type: 'application/json'
-    Authorization: 'Bearer {GMAIL_ACCESS_TOKEN}'
-  
-  # Parameter encoding: automatically convert to/subject/body to MIME format
-  parameter_encoding:
-    - source: [to, subject, body, cc, bcc, is_html]
-      target: raw
-      encoding: mime_rfc2822_base64url
-  
-  body:
-    raw: '{raw}'
-
-authentication:
-  type: oauth2
-  provider: google
-  scopes:
-    - 'https://www.googleapis.com/auth/gmail.send'
-
-output_schema:
-  type: object
-  properties:
-    id:
-      type: string
-      description: Message ID of the sent email
-    threadId:
-      type: string
-      description: Thread ID of the sent email
-    labelIds:
-      type: array
-      items:
-        type: string
-      description: Label IDs applied to the message
-
-error_handling:
-  retry: 3
-  backoff_type: exponential
-  initial_delay_ms: 1000
-  max_delay_ms: 10000
-  retryable_status_codes:
-    - 429
-    - 500
-    - 502
-    - 503

package/tools/http-client/definition.yaml

@@ -1,73 +0,0 @@
-name: http-client
-version: "1.0.0"
-description: "Generic HTTP client for making API requests"
-
-parameters:
-  url:
-    type: string
-    description: "The URL to request"
-    required: true
-  method:
-    type: string
-    description: "HTTP method: GET, POST, PUT, DELETE"
-    required: false
-    default: "GET"
-    enum: [GET, POST, PUT, DELETE, PATCH]
-  headers:
-    type: object
-    description: "HTTP headers as key-value pairs"
-    required: false
-  body:
-    type: object
-    description: "Request body (for POST/PUT/PATCH)"
-    required: false
-
-execution:
-  type: http
-  method: GET
-  url: "{url}"
-  headers:
-    "Content-Type": "application/json"
-  body: "{body}"
-
-output_schema:
-  type: object
-  properties:
-    status:
-      type: number
-      description: "HTTP status code"
-    statusText:
-      type: string
-    headers:
-      type: object
-    data:
-      type: object
-      description: "Response body"
-
-error_handling:
-  retry: 3
-  backoff_type: exponential
-  initial_delay_ms: 1000
-  max_delay_ms: 10000
-
-rate_limiting:
-  enabled: true
-  requests_per_minute: 60
-
-examples:
-  - name: "Fetch GitHub user"
-    description: "Fetch GitHub user profile"
-    params:
-      url: "https://api.github.com/users/octocat"
-      method: "GET"
-  - name: "Post JSON data"
-    description: "POST JSON to an API endpoint"
-    params:
-      url: "https://jsonplaceholder.typicode.com/posts"
-      method: "POST"
-      body:
-        title: "Test"
-        body: "This is a test"
-        userId: 1
-
-tags: [http, api, network, client]