teems 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5255a4b8e6b5e3e23bcbd8f5f341a8945022c380ab6c2f76fa18c2b74ecc1ba4
-  data.tar.gz: c31fd7ed82087b636fafabb34f2acc10b8697fe918061fcecce7056b0e54fbb7
+  metadata.gz: 644504d1f8d334a4ddec54ef8f099424d1251dd6d15beef3c1b713da93f0ce0e
+  data.tar.gz: 9c93db615cbe58642f127856e6c70d8b9cd0eefd81625b666cdfab736095a4cd
 SHA512:
-  metadata.gz: 1128d0e53047f9cef7fca4111dabf95306cd98e06c83c539816838b3b7f21a75f84e45a0fdf111484bec7a17d91e56ad2c3c75254a2b40314a5c81d1d759cc3a
-  data.tar.gz: 506950f2200002e07101641e65282eae9018716f31a49fe1048ca83f87a7b759c403b2ffa1051183217d8fa9155ae9d98f06bd997d142439f2a5dd63145c728c
+  metadata.gz: b72dbf0beb2fc14d5af939699526bcc060f7dab85afd9ee4f49d7fa5272add46fcda9f3a345afd67db81e8bc01ce40ca0e3b739d6dfed65d279be0ecb4172d8d
+  data.tar.gz: 537ef91ebb3e91424172d4c3e17b8fb884cadccb5c670deaa62ee41737ffef59f650edde0cb068a81b4271983ac94fcc05befd82cd0cb1d6077803c8a488f817

data/README.md

@@ -1,8 +1,8 @@
 # teems
 
-A command-line interface for Microsoft Teams. Read messages, list channels and chats from the terminal.
+A command-line interface for Microsoft Teams. Read messages, manage your calendar, set out-of-office, and more — all from the terminal.
 
-Pure Ruby, no dependencies.
+Pure Ruby, no runtime dependencies. macOS only (uses Safari for authentication).
 
 ## Installation
 
@@ -22,63 +22,98 @@ gem install teems-*.gem
 ## Requirements
 
 - Ruby 3.2+
-- macOS (for Safari token extraction)
+- macOS (for Safari/WKWebView token extraction)
 - Microsoft Teams account
 
 ## Authentication
 
-teems requires authentication tokens from Teams. The easiest way is Safari automation:
-
 ```bash
-teems auth login
+teems auth login     # Authenticate (headless or Safari)
+teems auth status    # Check if authenticated
+teems auth logout    # Clear stored tokens
 ```
 
-This opens Safari to teams.microsoft.com, waits for you to log in, then extracts the tokens.
+Tokens refresh automatically when you run commands. If they expire (~24 hours of inactivity), just run `teems auth login` again.
+
+## Commands
 
-Alternatively, extract tokens manually:
+### Calendar
 
 ```bash
-teems auth manual
+teems cal                    # Today's events
+teems cal tomorrow           # Tomorrow's events
+teems cal --week             # This week's events
+teems cal show 3             # View details for event #3
+teems cal accept 3           # Accept event #3
+teems cal decline 3          # Decline event #3
+teems cal create "Standup" --start "tomorrow 09:00" --attendees alice@example.com
+teems cal delete 3           # Delete event #3
 ```
 
-## Usage
+### Messages
+
+```bash
+teems messages <chat-id>                    # Read from a chat
+teems messages <channel-id> -t <team-id>    # Read from a channel
+teems messages <chat-id> -n 50              # Show more messages
+```
 
-### List Teams and Channels
+### Channels and Chats
 
 ```bash
-teems channels
+teems channels       # List joined teams and channels
+teems chats          # List recent chats
+teems chats -n 50    # Show 50 chats
 ```
 
-### List Chats
+### Out of Office
 
 ```bash
-teems chats
-teems chats -n 50  # Show 50 chats
+teems ooo                          # Check OOO status
+teems ooo on                       # Enable OOO (auto-reply + presence)
+teems ooo on --message "Vacation"  # Custom message
+teems ooo on --start 2025-12-22 --end 2025-12-26  # Scheduled
+teems ooo on --event               # Also create a calendar event for your notify list
+teems ooo off                      # Disable OOO
+teems ooo config                   # Show OOO configuration
 ```
 
-### Read Messages
+### Meetings
 
 ```bash
-# Read from a chat
-teems messages <chat-id>
+teems meeting <thread-id>                          # View meeting summary
+teems meeting <thread-id> --chat                   # Show meeting chat
+teems meeting <thread-id> --transcript -o ~/Downloads  # Download transcript (VTT)
+teems meeting <thread-id> --recording -o ~/Downloads   # Download recording (MP4)
+teems meeting <thread-id> --recording --transcript -o ~/Downloads  # Both, with embedded subtitles
+teems meeting <event-id>                           # By calendar event ID (AAMk...)
+teems meeting "https://teams.microsoft.com/..."    # By Teams URL or recap link
+```
 
-# Read from a channel (requires team ID)
-teems messages <channel-id> -t <team-id>
+Recording download requires `ffmpeg` (`brew install ffmpeg`) and downloads via DASH streaming with 5 parallel threads. No browser required.
 
-# Show more messages
-teems messages <chat-id> -n 50
+### People
+
+```bash
+teems who              # Show your profile
+teems who john         # Search for a user
+teems org              # Show your org chart
+teems org john         # Org chart for "john"
 ```
 
-### Check Authentication Status
+### Status and Activity
 
 ```bash
-teems auth status
+teems status                          # Show your presence
+teems status --presence available     # Set presence
+teems status --message "In a meeting" # Set status message
+teems activity                        # Show activity feed
 ```
 
-### Clear Authentication
+### Sync
 
 ```bash
-teems auth logout
+teems sync             # Sync chat history locally
 ```
 
 ## Global Options
@@ -95,12 +130,29 @@ teems auth logout
 
 Configuration is stored in XDG-compliant directories:
 
-- Config: `~/.config/teems/`
+- Config: `~/.config/teems/config.json`
+- Tokens: `~/.config/teems/tokens.json`
 - Cache: `~/.cache/teems/`
 
+### OOO Defaults
+
+Set default messages and a notify list for the `ooo` command:
+
+```json
+{
+  "ooo": {
+    "internal_message": "I'm currently out of office.",
+    "external_message": "Thank you for your message. I'm out of office.",
+    "external_audience": "all",
+    "status_message": "Out of Office",
+    "notify": ["manager@example.com", "team@example.com"]
+  }
+}
+```
+
 ### Custom Endpoints
 
-By default, teems connects to commercial Microsoft Teams endpoints. To use a different environment (e.g., GCC, GCC High), add an `endpoints` section to `~/.config/teems/config.json`:
+By default, teems connects to commercial Microsoft Teams endpoints. To use a different environment (e.g., GCC, GCC High), add an `endpoints` section to your config:
 
 ```json
 {
@@ -113,22 +165,14 @@ By default, teems connects to commercial Microsoft Teams endpoints. To use a dif
 
 Available endpoint keys: `graph`, `teams`, `msgservice`, `presence`.
 
-## Token Expiration
-
-Teams tokens expire after ~24 hours. When you see authentication errors, run:
-
-```bash
-teems auth login
-```
-
 ## Development
 
 ```bash
 git clone https://github.com/ericboehs/teems
 cd teems
-rake check   # Syntax check
-rake test    # Run tests
-rake console # Interactive console
+bundle install
+rake test        # Run tests
+rake console     # Interactive console
 ```
 
 ## License

data/lib/teems/api/client.rb

@@ -32,8 +32,7 @@ module Teems
       end
 
       def delete(path)
-        base_url = Services::ConnectionPool::DEFAULT_ENDPOINTS[endpoint]
-        @api.delete("#{base_url}#{path}", endpoint_key: endpoint, account: @account)
+        @api.delete(endpoint, path, account: @account)
       end
     end
   end

data/lib/teems/api/meetings.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Teems
+  module Api
+    # API wrapper for meeting-related endpoints (Graph shares API)
+    class Meetings < Client
+      def share_preview(sharing_url)
+        encoded = encode_sharing_url(sharing_url)
+        post("/v1.0/shares/u!#{encoded}/driveItem/preview")
+      end
+
+      def share_item(sharing_url, select: nil)
+        encoded = encode_sharing_url(sharing_url)
+        params = select ? { '$select' => select } : {}
+        get("/v1.0/shares/u!#{encoded}/driveItem", params: params)
+      end
+
+      private
+
+      def encode_sharing_url(url)
+        [url].pack('m0').tr('+/', '-_').delete('=')
+      end
+    end
+  end
+end

data/lib/teems/cli.rb

@@ -8,6 +8,8 @@ module Teems
     def verbose_mode? = @argv.include?('-v') || @argv.include?('--verbose')
 
     def build_runner
+      return @runner_override if @runner_override
+
       out = verbose_mode? ? @output.with_verbose : @output
       Runner.new(output: out).tap { |new_runner| setup_verbose_logging(new_runner, out) if out.verbose? }
     end
@@ -45,6 +47,7 @@ module Teems
       'cal' => Commands::Cal,
       'channels' => Commands::Channels,
       'chats' => Commands::Chats,
+      'meeting' => Commands::Meeting,
       'messages' => Commands::Messages,
       'sync' => Commands::Sync,
       'who' => Commands::Who,
@@ -54,9 +57,10 @@ module Teems
       'help' => Commands::Help
     }.freeze
 
-    def initialize(argv, output: Formatters::Output.new)
+    def initialize(argv, output: Formatters::Output.new, runner: nil)
       @argv = argv.dup
       @output = output
+      @runner_override = runner
     end
 
     def run

data/lib/teems/commands/base.rb

@@ -119,6 +119,7 @@ module Teems
 
       def require_auth
         return nil if runner.configured?
+        return nil if auto_login
 
         error('Not authenticated. Run: teems auth login')
         1
@@ -137,9 +138,21 @@ module Teems
 
       def attempt_token_refresh
         debug('Token expired, attempting refresh...')
-        raise ApiError, 'Token refresh failed' unless runner.refresh_tokens
+        return debug('Token refreshed, retrying request...') if runner.refresh_tokens
 
-        debug('Token refreshed, retrying request...')
+        debug('Token refresh failed, re-authenticating...')
+        raise ApiError, 'Re-authentication failed' unless auto_login
+      end
+
+      def auto_login
+        tokens = runner.token_extractor.extract
+        return unless tokens&.[](:auth_token) && tokens[:skype_token]
+
+        runner.token_store.save(**tokens)
+        true
+      rescue Teems::Error, IOError, SystemCallError => e
+        debug("Auto-login failed: #{e.message}")
+        nil
       end
     end
   end

data/lib/teems/commands/help.rb

@@ -8,6 +8,7 @@ module Teems
       ['cal', 'List calendar events and view details'],
       ['channels', 'List joined teams and channels'],
       ['chats', 'List recent chats'],
+      ['meeting', 'View meeting details, chat, transcripts, and recordings'],
       ['messages', 'Read messages from a channel or chat'],
       ['sync', 'Sync chat history locally'],
       ['who', "Look up a user's profile"],