matimo 0.1.0-alpha.3 → 0.1.0-alpha.4

package/tools/slack/slack_join_channel/definition.yaml

@@ -1,35 +0,0 @@
-name: slack_join_channel
-description: |-
-  Add bot to a channel.
-  Uses conversations.join API method.
-  Bot must be invited to private channels by an admin first.
-version: '1.0.0'
-parameters:
-  channel:
-    type: string
-    required: true
-    description: |-
-      Channel ID or name to join.
-      Format: C followed by alphanumeric (e.g., C123456)
-execution:
-  type: http
-  method: POST
-  url: 'https://slack.com/api/conversations.join'
-  headers:
-    Authorization: 'Bearer {SLACK_BOT_TOKEN}'
-    Content-Type: application/json
-  body:
-    channel: '{channel}'
-  timeout: 10000
-authentication:
-  type: api_key
-  location: header
-  name: Authorization
-notes:
-  env: SLACK_BOT_TOKEN
-  scopes: channels:manage
-  important: |-
-    - Public channels: Bot joins automatically
-    - Private channels: Admin must invite bot first
-    - Bot cannot join archived channels
-    - Use for gaining access before sending messages

package/tools/slack/slack_reply_to_message/definition.yaml

@@ -1,49 +0,0 @@
-name: slack_reply_to_message
-description: |-
-  Post a reply to a message thread.
-  Uses chat.postMessage API method with thread_ts parameter.
-version: '1.0.0'
-parameters:
-  channel:
-    type: string
-    required: true
-    description: Channel ID containing the parent message
-  thread_ts:
-    type: string
-    required: true
-    description: |-
-      Timestamp of the parent message that starts the thread.
-      Use parent's ts value, never use a reply's ts value.
-  text:
-    type: string
-    required: false
-    description: |-
-      Reply text (optional if using blocks for rich formatting).
-      Recommended as fallback for notifications and accessibility.
-  blocks:
-    type: array
-    required: false
-    description: Block Kit JSON array for rich message formatting
-execution:
-  type: http
-  method: POST
-  url: 'https://slack.com/api/chat.postMessage'
-  headers:
-    Authorization: 'Bearer {SLACK_BOT_TOKEN}'
-    Content-Type: application/json
-  body:
-    channel: '{channel}'
-    text: '{text}'
-    thread_ts: '{thread_ts}'
-  timeout: 15000
-authentication:
-  type: api_key
-  location: header
-  name: Authorization
-notes:
-  env: SLACK_BOT_TOKEN
-  scopes: chat:write
-  important: |-
-    - thread_ts must be parent message timestamp, not a reply
-    - Either text or blocks is recommended (both optional)
-    - Threads keep conversations organized by topic

package/tools/slack/slack_search_messages/definition.yaml

@@ -1,46 +0,0 @@
-name: slack_search_messages
-description: |-
-  Search across Slack message history.
-  Uses search.messages API method.
-  Supports filtering by channel, date range, and other criteria.
-version: '1.0.0'
-parameters:
-  query:
-    type: string
-    required: true
-    description: |-
-      Search query text.
-      Supports operators: from:@user, in:#channel, after:YYYY-MM-DD, etc.
-  sort:
-    type: string
-    required: false
-    description: |-
-      Sort results by: score (relevance, default) or timestamp
-  count:
-    type: number
-    required: false
-    description: |-
-      Number of results to return.
-      Default: 20, Max: 100
-execution:
-  type: http
-  method: GET
-  url: 'https://slack.com/api/search.messages'
-  headers:
-    Authorization: 'Bearer {SLACK_BOT_TOKEN}'
-  query_params:
-    query: '{query}'
-    sort: '{sort}'
-    count: '{count}'
-  timeout: 15000
-authentication:
-  type: api_key
-  location: header
-  name: Authorization
-notes:
-  env: SLACK_BOT_TOKEN
-  scopes: search:read
-  important: |-
-    - Query supports advanced search operators
-    - Example: "from:@alice in:#engineering after:2024-01-01"
-    - Default sort is by relevance score

package/tools/slack/slack_send_channel_message/definition.yaml

@@ -1,34 +0,0 @@
-name: slack_send_channel_message
-description: Post a message (text, markdown, blocks) to a public/private Slack channel.
-version: '1.0.0'
-parameters:
-  channel:
-    type: string
-    required: true
-    description: Channel ID or name to post the message to
-  text:
-    type: string
-    required: false
-    description: Plain-text message (optional if blocks provided, recommended as fallback for accessibility)
-  blocks:
-    type: array
-    required: false
-    description: Slack Block Kit JSON blocks (optional, used instead of text for rich formatting)
-execution:
-  type: http
-  method: POST
-  url: 'https://slack.com/api/chat.postMessage'
-  headers:
-    Authorization: 'Bearer {SLACK_BOT_TOKEN}'
-    Content-Type: application/json
-  body:
-    channel: '{channel}'
-    text: '{text}'
-  timeout: 15000
-authentication:
-  type: api_key
-  location: header
-  name: Authorization
-notes:
-  env: SLACK_BOT_TOKEN
-  caution: Ensure `chat:write` scope and bot membership in private channels. Either text or blocks is recommended (not both required). Unresolved placeholders (e.g., {blocks} when not provided) will be sent as literal strings per Slack API contract.

package/tools/slack/slack_send_dm/definition.yaml

@@ -1,37 +0,0 @@
-name: slack_send_dm
-description: |-
-  Open or resume a direct message (DM) or multi-person direct message (MPIM) conversation.
-  Uses conversations.open API method.
-  After opening, use chat.postMessage to send the actual message.
-version: '1.0.0'
-parameters:
-  user:
-    type: string
-    required: true
-    description: |-
-      User ID or comma-separated user IDs for multi-person DM.
-      - 1 user ID: Creates a 1:1 DM
-      - Multiple user IDs (2-8): Creates an MPIM
-      Do not include the authenticated bot's user ID.
-execution:
-  type: http
-  method: POST
-  url: 'https://slack.com/api/conversations.open'
-  headers:
-    Authorization: 'Bearer {SLACK_BOT_TOKEN}'
-    Content-Type: application/json
-  body:
-    users: '{user}'
-  timeout: 15000
-authentication:
-  type: api_key
-  location: header
-  name: Authorization
-notes:
-  env: SLACK_BOT_TOKEN
-  scopes: im:write, mpim:write
-  important: |-
-    - This method OPENS a conversation, it does not send a message
-    - Returns channel ID (D...) to use with chat.postMessage
-    - Subsequent calls with same users return existing conversation
-    - For 1:1 DMs, use user ID (U...), not DM channel ID (D...)

package/tools/slack/slack_set_channel_topic/definition.yaml

@@ -1,40 +0,0 @@
-name: slack_set_channel_topic
-description: |-
-  Set or update the topic (description) for a channel.
-  Uses conversations.setTopic API method.
-  Topic is displayed below the channel name in Slack UI.
-version: '1.0.0'
-parameters:
-  channel:
-    type: string
-    required: true
-    description: Channel ID to update
-  topic:
-    type: string
-    required: true
-    description: |-
-      New topic text.
-      Max 250 characters.
-      Supports text formatting (@mentions, links, etc.)
-execution:
-  type: http
-  method: POST
-  url: 'https://slack.com/api/conversations.setTopic'
-  headers:
-    Authorization: 'Bearer {SLACK_BOT_TOKEN}'
-    Content-Type: application/json
-  body:
-    channel: '{channel}'
-    topic: '{topic}'
-  timeout: 10000
-authentication:
-  type: api_key
-  location: header
-  name: Authorization
-notes:
-  env: SLACK_BOT_TOKEN
-  scopes: conversations:manage
-  important: |-
-    - Bot must be channel member to set topic
-    - Topic limited to 250 characters
-    - Visible in channel info below channel name

package/tools/slack/slack_upload_file/definition.yaml

@@ -1,152 +0,0 @@
-name: slack_upload_file
-description: |-
-  Upload a file to Slack using the modern files API.
-  
-  This tool provides a simplified interface to upload files to Slack.
-  It uses the latest Slack file upload API (files.getUploadURLExternal + files.completeUploadExternal)
-  introduced in 2024 as the recommended approach.
-  
-  FEATURES:
-  ✅ Supports files up to 500MB
-  ✅ Share directly to channels during upload
-  ✅ Add file title and initial comment
-  ✅ Better error handling and retry logic
-  ✅ Modern, official Slack recommended API
-  ✅ Future-proof (won't be deprecated)
-  
-  REQUIRED SCOPES:
-  • files:write - Required to upload files
-  
-  API REFERENCE:
-  https://docs.slack.dev/reference/methods/files.getUploadURLExternal
-  https://docs.slack.dev/reference/methods/files.completeUploadExternal
-version: '1.0.0'
-parameters:
-  filename:
-    type: string
-    required: true
-    description: |-
-      Name of the file (e.g., "report.pdf", "data.json")
-      Used as the file name in Slack
-  file_size:
-    type: number
-    required: true
-    description: |-
-      Size of the file in bytes.
-      Maximum 500MB (524,288,000 bytes)
-      Must match actual file size for upload
-  channel_id:
-    type: string
-    required: true
-    description: |-
-      Channel ID to share file with.
-      Example: "C024BE91L"
-      Bot must be a member of the channel
-  title:
-    type: string
-    required: false
-    description: |-
-      Title for the file in Slack (separate from filename).
-      If not provided, filename is used as title.
-      Supports up to 255 characters
-  initial_comment:
-    type: string
-    required: false
-    description: |-
-      Message text to introduce the file in the channel.
-      Example: "Here's the quarterly report PDF"
-      Supports markdown formatting
-execution:
-  type: http
-  method: POST
-  url: 'https://slack.com/api/files.getUploadURLExternal'
-  headers:
-    Authorization: 'Bearer {SLACK_BOT_TOKEN}'
-    Content-Type: application/json
-  body:
-    filename: '{filename}'
-    length: '{file_size}'
-  timeout: 30000
-authentication:
-  type: api_key
-  location: header
-  name: Authorization
-output_schema:
-  type: object
-  properties:
-    ok:
-      type: boolean
-      description: Whether the request was successful
-    upload_url:
-      type: string
-      description: URL where to upload the file binary
-    file_id:
-      type: string
-      description: Unique identifier for the uploaded file
-    upload_url_expires:
-      type: number
-      description: Unix timestamp when the upload URL expires
-notes:
-  env: SLACK_BOT_TOKEN
-  
-  api_version: |-
-    Modern API (Current - Recommended)
-    • Uses: files.getUploadURLExternal (get upload URL)
-    • Uses: files.completeUploadExternal (complete upload)
-    • Introduced: 2024
-    • Status: Official Slack recommendation
-    • Maintenance: Actively maintained
-  
-  scopes_required: |-
-    • files:write - Required to upload files
-    • channels:read - Optional, to validate channel IDs
-  
-  usage_pattern: |-
-    TWO-STEP PROCESS:
-    
-    1. Get Upload URL (this tool):
-       Call with: filename, file_size, channel_id
-       Returns: upload_url, file_id, upload_url_expires
-    
-    2. Upload File Binary (manual/SDK):
-       Method: HTTP PUT to upload_url
-       Headers: Content-Type: application/octet-stream
-       Body: Raw file binary content
-    
-    3. Complete Upload (use slack_complete_file_upload):
-       Call with: file_id, channel_id, title, initial_comment
-       Returns: File object with sharing info
-  
-  important: |-
-    • Bot requires files:write scope
-    • File size must match file_size parameter exactly
-    • Upload URL expires (check upload_url_expires)
-    • If URL expires, start over with fresh getUploadURLExternal call
-    • Channel ID must be one where bot is a member
-  
-  best_practices: |-
-    DO:
-    ✅ Check upload_url_expires before uploading large files
-    ✅ Use Content-Type: application/octet-stream for PUT
-    ✅ Verify file_size matches actual file size
-    ✅ Include initial_comment for context when sharing
-    ✅ Validate channel_id exists before uploading
-    
-    DON'T:
-    ❌ Use channels bot hasn't joined
-    ❌ Wait too long between getting URL and uploading (URLs expire ~2 hours)
-    ❌ Forget to call slack_complete_file_upload after upload
-    ❌ Include sensitive data in initial_comment
-  
-  limitations: |-
-    • Maximum file size: 500MB
-    • Upload URL valid for approximately 2 hours
-    • Bot must be member of channel to share
-    • Response format follows Slack Web API standards
-  
-  changelog: |-
-    Version 1.0.0 (Feb 2026):
-    • Updated to use modern files.getUploadURLExternal API
-    • Replaces deprecated files.upload (sunset Nov 12, 2025)
-    • Supports up to 500MB files
-    • Better error handling