bundleup-sdk 0.4.1 → 0.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e2898652fed3548927b24223483a9308f826e2899503c4eb711275d9418145a
-  data.tar.gz: ec2179acf284beb8c8e94a1079c671ee2a3a5218905d9187648b62120bcbcaa4
+  metadata.gz: 6a81131b46ad1f04a1714e8e7a07d87d69ee3419648e966daa9099cba31fb4a9
+  data.tar.gz: b1861d43ace1fd90f86e89e8b161b91c135f1fc53215cf0dad3defd95351a048
 SHA512:
-  metadata.gz: 4bf6f9e0912c4cefbc510011e4475743517c21fe324c428ccb8e2b44a24104c2fa3299069edcafca8cf1c47879d6620792fada35af230414f34e138dd5742990
-  data.tar.gz: 5dce15658d4a193bc89771b8726a1e5faea4326f7c20c76ed7c1b23a9e4eef01c1bf30e7ec785a2f478e2610fc193078f8c1d0adca4ecda0557a7846d6b07963
+  metadata.gz: 13c18248fe861fb462cf3d9019764d13a7925031b49aa40d37f5ab7c3b106e019407140873dda6467057777313bc58cc6cb661daac8f102ff462b318aec4c413
+  data.tar.gz: c3bc826ddfb41e39616049a651b180dffd36bb3ee939f27ee315bd350400ae25dbec72666025f22860944d20f82e1945dc20f856b7a2c2cc0302cb671b7b0f9f

data/README.md

@@ -83,7 +83,7 @@ Runnable examples are available in the [`examples/`](./examples) directory:
 
 - [`examples/basic_usage.rb`](./examples/basic_usage.rb) - Client setup, connections, integrations, and webhooks
 - [`examples/proxy_api.rb`](./examples/proxy_api.rb) - Proxy API GET request with a connection
-- [`examples/unify_api.rb`](./examples/unify_api.rb) - Unify Chat, Git, PM, Ticketing, and Drive endpoint usage
+- [`examples/unify_api.rb`](./examples/unify_api.rb) - Unify Chat, Git, PM, Ticketing, Drive, and Calendar endpoint usage
 - [`examples/README.md`](./examples/README.md) - Setup and execution instructions
 
 ## Quick Start
@@ -146,7 +146,7 @@ client = BundleUp::Client.new(ENV['BUNDLEUP_API_KEY'])
 **Example `.env` file:**
 
 ```bash
-BUNDLEUP_API_KEY=bu_live_1234567890abcdefghijklmnopqrstuvwxyz
+BUNDLEUP_API_KEY=Zw7Lt7JacsDyMCEpnZdGptgnJaOdMzFVH9QtIthnL5RviYP5WeH6e9FWP2HzEO
 ```
 
 **Loading environment variables (using dotenv):**
@@ -737,6 +737,35 @@ end
 puts "Fetched #{all_channels.length} total channels"
 ```
 
+##### List Messages
+
+Messages in one channel, newest first. `author.name` is nil on Slack, which returns only a user id on a message.
+
+```ruby
+result = unify.chat.messages('C123', limit: 100, after: nil, include_raw: false)
+
+puts "Messages: #{result['data']}"
+```
+
+**Response:**
+
+```ruby
+{
+  'data' => [
+    {
+      'id' => '1755712345.123456',
+      'text' => 'Deploy finished',
+      'author' => { 'id' => 'U024BE7LH', 'name' => nil },
+      'created_at' => '2026-08-20T18:32:25.123Z',
+      'thread_id' => nil
+    }
+  ],
+  'metadata' => {
+    'next' => 'cursor_def456'
+  }
+}
+```
+
 ##### Send Message
 
 Send a message to a channel on the connected chat platform.
@@ -971,6 +1000,34 @@ open_tickets = result['data'].select { |ticket| ticket['status'] == 'open' }
 sorted_by_date = result['data'].sort_by { |ticket| Time.parse(ticket['created_at']) }.reverse
 ```
 
+##### Get a Ticket
+
+Fetch one ticket by ID. Not supported by Basecamp, whose API only serves a to-do underneath its project.
+
+```ruby
+result = unify.ticketing.ticket('PROJ-123')
+
+puts "Ticket: #{result['data']}"
+```
+
+**Response:**
+
+```ruby
+{
+  'data' => {
+    'id' => 'PROJ-123',
+    'url' => 'https://jira.example.com/browse/PROJ-123',
+    'title' => 'Fix login bug',
+    'status' => 'in_progress',
+    'description' => 'Users are unable to log in',
+    'created_at' => '2024-01-15T10:30:00Z',
+    'updated_at' => '2024-01-20T14:22:00Z'
+  }
+}
+```
+
+A single resource carries no pagination, so there is no `metadata` on this response.
+
 #### CRM API
 
 The CRM API provides a unified interface for CRM platforms like Attio, HubSpot, PipeDrive, Salesforce and Zoho.
@@ -1071,6 +1128,49 @@ puts "Files: #{result['data']}"
 }
 ```
 
+#### Calendar API
+
+The Calendar API provides a unified interface for calendar and scheduling platforms like Google Calendar, Outlook, Calendly and Zoom.
+
+##### List Events
+
+`starts_after` and `starts_before` are required — the endpoint refuses an unbounded listing.
+
+```ruby
+result = unify.calendar.events(
+  starts_after: '2026-09-01T00:00:00Z',
+  starts_before: '2026-09-08T00:00:00Z',
+  limit: 100,
+  after: nil,
+  include_raw: false
+)
+
+puts "Events: #{result['data']}"
+```
+
+**Response:**
+
+```ruby
+{
+  'data' => [
+    {
+      'id' => 'evt_123',
+      'title' => 'Design review',
+      'description' => 'Walk through the new onboarding flow',
+      'start_date' => '2026-09-01T15:00:00Z',
+      'end_date' => '2026-09-01T16:00:00Z',
+      'status' => 'confirmed',
+      'url' => 'https://calendar.google.com/event?eid=...'
+    }
+  ],
+  'metadata' => {
+    'next' => nil
+  }
+}
+```
+
+Recurring events are expanded into their occurrences. All-day events carry a `YYYY-MM-DD` date rather than a timestamp. Attendees, conferencing links and organizers are available through `include_raw` or the Proxy API.
+
 ## Error Handling
 
 The SDK raises exceptions for errors. Always wrap SDK calls in rescue blocks for proper error handling.
@@ -1126,7 +1226,8 @@ lib/
 │       ├── git.rb           # Git Unify API
 │       ├── ticketing.rb     # Ticketing Unify API
 │       ├── crm.rb           # CRM Unify API
-│       └── drive.rb         # Drive Unify API
+│       ├── drive.rb         # Drive Unify API
+│       └── calendar.rb      # Calendar Unify API
 sig/                         # RBS type signatures (mirrors lib/)
 spec/                        # Test files
 ```

data/lib/bundleup/mcp.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require 'json'
-require_relative 'mcp_client'
 
 module BundleUp
   # Transport for a connection's MCP server.
@@ -68,4 +67,201 @@ module BundleUp
       @connection ||= Faraday.new { |faraday| faraday.adapter Faraday.default_adapter }
     end
   end
+
+  # A connected MCP session.
+  #
+  # Tools, resources and prompts are defined by the provider — BundleUp does
+  # not rename or normalize them.
+  class MCPClient
+    PROTOCOL_VERSION = '2025-06-18'
+    CLIENT_NAME = 'bundleup-sdk'
+
+    def initialize(base_url, api_key, connection_id)
+      @base_url = base_url
+      @api_key = api_key
+      @connection_id = connection_id
+      @session_id = nil
+      @connected = false
+      @last_id = 0
+    end
+
+    # List the provider's tools, following pagination to the end.
+    def list_tools
+      paginate('tools/list', 'tools')
+    end
+
+    # Call a tool by name, with arguments matching its own input schema.
+    def call_tool(name, args = {})
+      raise ArgumentError, 'Tool name is required to call a tool.' if blank?(name)
+
+      connect
+      send_message('tools/call', { name: name, arguments: args })
+    end
+
+    # List the provider's resources, following pagination to the end.
+    def list_resources
+      paginate('resources/list', 'resources')
+    end
+
+    # Read a resource by URI.
+    def read_resource(uri)
+      raise ArgumentError, 'Resource URI is required to read a resource.' if blank?(uri)
+
+      connect
+      send_message('resources/read', { uri: uri })
+    end
+
+    # List the provider's prompts, following pagination to the end.
+    def list_prompts
+      paginate('prompts/list', 'prompts')
+    end
+
+    # Get a prompt by name.
+    def get_prompt(name, args = {})
+      raise ArgumentError, 'Prompt name is required to get a prompt.' if blank?(name)
+
+      connect
+      send_message('prompts/get', { name: name, arguments: args })
+    end
+
+    # Send any other JSON-RPC method on this session.
+    def request(method, params = nil)
+      raise ArgumentError, 'Method is required to send a request.' if blank?(method)
+
+      connect
+      send_message(method, params)
+    end
+
+    # End the session and reset local state.
+    def close
+      delete_session if @session_id
+
+      @session_id = nil
+      @connected = false
+      nil
+    end
+
+    private
+
+    def blank?(value)
+      value.nil? || value.to_s.empty?
+    end
+
+    def default_headers
+      headers = {
+        'Authorization' => "Bearer #{@api_key}",
+        'Content-Type' => 'application/json',
+        'Accept' => 'application/json, text/event-stream',
+        'BU-Connection-Id' => @connection_id
+      }
+      headers['Mcp-Session-Id'] = @session_id if @session_id
+      headers
+    end
+
+    def connection
+      @connection ||= Faraday.new { |faraday| faraday.adapter Faraday.default_adapter }
+    end
+
+    def post_payload(payload)
+      response = connection.post(@base_url, payload.to_json, default_headers)
+      session_id = response.headers['mcp-session-id']
+      @session_id = session_id if session_id
+
+      raise error_for(response) unless response.success?
+
+      response
+    end
+
+    def error_for(response)
+      fallback = "MCP request failed with status #{response.status}."
+      parsed = JSON.parse(response.body.to_s)
+      return RuntimeError.new(fallback) unless parsed.is_a?(Hash) && parsed['message']
+
+      code = parsed['code']
+      RuntimeError.new(code ? "#{parsed['message']} (#{code})" : parsed['message'])
+    rescue JSON::ParserError
+      RuntimeError.new(fallback)
+    end
+
+    # Run the MCP handshake, once. Deferred until the first call.
+    def connect
+      return if @connected
+
+      send_message('initialize', handshake_params)
+      post_payload({ jsonrpc: '2.0', method: 'notifications/initialized' })
+      @connected = true
+    end
+
+    def handshake_params
+      {
+        protocolVersion: PROTOCOL_VERSION,
+        capabilities: {},
+        clientInfo: { name: CLIENT_NAME, version: BundleUp::VERSION }
+      }
+    end
+
+    def send_message(method, params = nil)
+      @last_id += 1
+      payload = { jsonrpc: '2.0', id: @last_id, method: method }
+      payload[:params] = params unless params.nil?
+
+      message = parse(post_payload(payload), @last_id)
+      raise "No response received for #{method}." if message.nil?
+      raise message['error']['message'].to_s if message['error']
+
+      message['result'] || {}
+    end
+
+    # Providers may answer a plain request/response over text/event-stream.
+    def parse(response, message_id)
+      body = response.body.to_s
+      return nil if body.empty?
+
+      content_type = response.headers['content-type'].to_s
+      return JSON.parse(body) unless content_type.include?('text/event-stream')
+
+      parse_stream(body, message_id)
+    end
+
+    def parse_stream(body, message_id)
+      body.gsub("\r\n", "\n").split("\n\n").each do |event|
+        data = event_data(event)
+        next if data.empty?
+
+        message = JSON.parse(data)
+        # Skip server notifications interleaved on the stream.
+        return message if message.is_a?(Hash) && message['id'] == message_id
+      end
+
+      nil
+    end
+
+    def event_data(event)
+      event.split("\n")
+           .select { |line| line.start_with?('data:') }
+           .map { |line| line.sub('data:', '').strip }
+           .join("\n")
+    end
+
+    def paginate(method, key)
+      connect
+      items = []
+      cursor = nil
+
+      loop do
+        result = send_message(method, cursor ? { cursor: cursor } : nil)
+        items.concat(result[key] || [])
+        cursor = result['nextCursor']
+        break unless cursor
+      end
+
+      items
+    end
+
+    def delete_session
+      connection.delete(@base_url, nil, default_headers)
+    rescue Faraday::Error
+      nil
+    end
+  end
 end

data/lib/bundleup/unify/calendar.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module BundleUp
+  module Unify
+    # Client for Calendar-related Unify endpoints.
+    class Calendar < Base
+      # Fetches events from the connected calendar provider.
+      #
+      # +params+ must carry +starts_after+ and +starts_before+ (ISO 8601) —
+      # the endpoint refuses an unbounded listing.
+      def events(params = {})
+        raise ArgumentError, 'starts_after and starts_before are required to fetch events.' if window_missing?(params)
+
+        response = connection.get('calendar/events') do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch calendar/events: #{response.status}" unless response.success?
+
+        response.body
+      end
+
+      private
+
+      def window_missing?(params)
+        params ||= {}
+
+        %i[starts_after starts_before].any? do |key|
+          value = params[key] || params[key.to_s]
+          value.nil? || value.to_s.empty?
+        end
+      end
+    end
+  end
+end

data/lib/bundleup/unify/chat.rb

@@ -26,6 +26,26 @@ module BundleUp
         response.body
       end
 
+      # Fetches messages in a channel from the connected chat provider.
+      #
+      # Newest first. +author.name+ is nil on Slack, which returns only a user
+      # id on a message.
+      def messages(channel_id, params = {})
+        raise ArgumentError, 'channel_id is required to fetch messages.' if channel_id.nil?
+
+        encoded_channel_id = URI.encode_www_form_component(channel_id)
+
+        response = connection.get("chat/channels/#{encoded_channel_id}/messages") do |req|
+          req.params = params
+        end
+
+        unless response.success?
+          raise "Failed to fetch chat/channels/#{encoded_channel_id}/messages: #{response.status}"
+        end
+
+        response.body
+      end
+
       # Sends a message to a channel on the connected chat provider.
       def message(channel_id, text)
         raise ArgumentError, 'channel_id is required to send a message.' if channel_id.nil?

data/lib/bundleup/unify/mcp.rb

@@ -29,15 +29,15 @@ module BundleUp
       end
 
       # List the available unified tools.
-      def tools
-        @client.tools
+      def list_tools
+        @client.list_tools
       end
 
       # Call a unified tool with optional arguments.
-      def tool(name, args = {})
+      def call_tool(name, args = {})
         raise ArgumentError, 'Tool name is required to call a tool.' if name.nil? || name.to_s.empty?
 
-        @client.tool(name, args)
+        @client.call_tool(name, args)
       end
     end
   end

data/lib/bundleup/unify/me.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module BundleUp
+  module Unify
+    # Client for the root-level identity endpoint.
+    #
+    # `me` is the one unified method every provider implements, so the API mounts
+    # it at the root rather than under a vertical. It is exposed on the Unify
+    # client as `unify.me` rather than as a namespace.
+    class Me < Base
+      # Fetches the account the connection is authenticated as.
+      #
+      # Providers that authorize per workspace, portal, tenant or company return
+      # that account instead of a user, and fields the provider does not expose
+      # come back as nil.
+      def get(params = {})
+        response = connection.get('me') do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch me: #{response.status}" unless response.success?
+
+        response.body
+      end
+    end
+  end
+end

data/lib/bundleup/unify/ticketing.rb

@@ -14,6 +14,30 @@ module BundleUp
 
         response.body
       end
+
+      # Fetches a single ticket by ID from the connected ticketing tool.
+      #
+      # Not supported by Basecamp, whose API only serves a to-do underneath its
+      # project — an id on its own cannot address one.
+      def ticket(ticket_id, params = {})
+        raise ArgumentError, 'ticket_id is required to fetch a ticket.' if blank?(ticket_id)
+
+        encoded_id = URI.encode_www_form_component(ticket_id)
+
+        response = connection.get("ticketing/tickets/#{encoded_id}") do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch ticketing/tickets/#{encoded_id}: #{response.status}" unless response.success?
+
+        response.body
+      end
+
+      private
+
+      def blank?(value)
+        value.nil? || value.to_s.empty?
+      end
     end
   end
 end

data/lib/bundleup/unify.rb

@@ -12,6 +12,7 @@ module BundleUp
         @git = BundleUp::Unify::Git.new(api_key, connection_id)
         @crm = BundleUp::Unify::CRM.new(api_key, connection_id)
         @drive = BundleUp::Unify::Drive.new(api_key, connection_id)
+        @calendar = BundleUp::Unify::Calendar.new(api_key, connection_id)
         @api_key = api_key
         @connection_id = connection_id
       end
@@ -41,6 +42,19 @@ module BundleUp
         @drive ||= BundleUp::Unify::Drive.new(api_key, connection_id)
       end
 
+      # Access the Calendar API for the connection.
+      def calendar
+        @calendar ||= BundleUp::Unify::Calendar.new(api_key, connection_id)
+      end
+
+      # Fetch the account this connection is authenticated as.
+      #
+      # `me` is the one unified method every provider implements, so it hangs off
+      # the Unify client directly instead of a vertical namespace.
+      def me(params = {})
+        (@me ||= BundleUp::Unify::Me.new(api_key, connection_id)).get(params)
+      end
+
       # Access the Unified MCP server for the connection.
       def mcp
         @mcp ||= BundleUp::Unify::MCP.new(api_key, connection_id)

data/lib/bundleup/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BundleUp
-  VERSION = '0.4.1'
+  VERSION = '0.4.3'
 end

data/lib/bundleup.rb

@@ -21,7 +21,9 @@ require_relative 'bundleup/unify/git'
 require_relative 'bundleup/unify/ticketing'
 require_relative 'bundleup/unify/crm'
 require_relative 'bundleup/unify/drive'
+require_relative 'bundleup/unify/calendar'
 require_relative 'bundleup/unify/mcp'
+require_relative 'bundleup/unify/me'
 
 # Main module for the BundleUp SDK.
 module BundleUp

data/sig/bundleup/unify/calendar.rbs

@@ -0,0 +1,23 @@
+module BundleUp
+  module Unify
+    class Calendar < Base
+      type calendar_event = {
+        id: String,
+        title: String?,
+        description: String?,
+        start_date: String?,
+        end_date: String?,
+        status: String?,
+        url: String?
+      }
+
+      type metadata = { next: String? }
+
+      def events: (?Hash[Symbol, untyped] params) -> { data: Array[calendar_event], metadata: metadata }
+
+      private
+
+      def window_missing?: (Hash[Symbol, untyped]?) -> bool
+    end
+  end
+end

data/sig/bundleup/unify/chat.rbs

@@ -3,10 +3,21 @@ module BundleUp
     class Chat < Base
       type chat_user = { id: String, name: String }
       type chat_channel = { id: String, name: String }
+      type chat_author = { id: String?, name: String? }
+
+      type chat_message = {
+        id: String,
+        text: String?,
+        author: chat_author?,
+        created_at: String?,
+        thread_id: String?
+      }
+
       type metadata = { next: String? }
 
       def users: (?Hash[Symbol, untyped] params) -> { data: Array[chat_user], metadata: metadata }
       def channels: (?Hash[Symbol, untyped] params) -> { data: Array[chat_channel], metadata: metadata }
+      def messages: (String channel_id, ?Hash[Symbol, untyped] params) -> { data: Array[chat_message], metadata: metadata }
       def message: (String channel_id, String text) -> { data: Hash[String, untyped] }
     end
   end

data/sig/bundleup/unify/me.rbs

@@ -0,0 +1,14 @@
+module BundleUp
+  module Unify
+    class Me < Base
+      type account = {
+        id: String?,
+        name: String?,
+        email: String?,
+        avatar_url: String?
+      }
+
+      def get: (?Hash[Symbol, untyped] params) -> { data: account }
+    end
+  end
+end

data/sig/bundleup/unify/ticketing.rbs

@@ -11,9 +11,25 @@ module BundleUp
         updated_at: String
       }
 
+      type ticket = {
+        id: String,
+        title: String,
+        status: String?,
+        url: String?,
+        description: String?,
+        created_at: String?,
+        updated_at: String?
+      }
+
       type metadata = { next: String? }
 
-      def issues: (?Hash[Symbol, untyped] params) -> { data: Array[ticketing_ticket], metadata: metadata }
+      def tickets: (?Hash[Symbol, untyped] params) -> { data: Array[ticketing_ticket], metadata: metadata }
+
+      def ticket: (String ticket_id, ?Hash[Symbol, untyped] params) -> { data: ticket }
+
+      private
+
+      def blank?: (untyped) -> bool
     end
   end
 end

data/sig/bundleup/unify.rbs

@@ -11,6 +11,8 @@ module BundleUp
       def pm: () -> PM
       def crm: () -> CRM
       def drive: () -> Drive
+      def calendar: () -> Calendar
+      def me: (?Hash[Symbol, untyped] params) -> { data: Me::account }
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bundleup-sdk
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.4.3
 platform: ruby
 authors:
 - BundleUp
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-25 00:00:00.000000000 Z
+date: 2026-08-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -177,19 +177,23 @@ files:
 - lib/bundleup/resources/webhook.rb
 - lib/bundleup/unify.rb
 - lib/bundleup/unify/base.rb
+- lib/bundleup/unify/calendar.rb
 - lib/bundleup/unify/chat.rb
 - lib/bundleup/unify/crm.rb
 - lib/bundleup/unify/drive.rb
 - lib/bundleup/unify/git.rb
 - lib/bundleup/unify/mcp.rb
+- lib/bundleup/unify/me.rb
 - lib/bundleup/unify/ticketing.rb
 - lib/bundleup/version.rb
 - sig/bundleup/unify.rbs
 - sig/bundleup/unify/base.rbs
+- sig/bundleup/unify/calendar.rbs
 - sig/bundleup/unify/chat.rbs
 - sig/bundleup/unify/crm.rbs
 - sig/bundleup/unify/drive.rbs
 - sig/bundleup/unify/git.rbs
+- sig/bundleup/unify/me.rbs
 - sig/bundleup/unify/ticketing.rbs
 homepage: https://github.com/bundleup/bundleup-sdk-ruby
 licenses: