teems 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5255a4b8e6b5e3e23bcbd8f5f341a8945022c380ab6c2f76fa18c2b74ecc1ba4
-  data.tar.gz: c31fd7ed82087b636fafabb34f2acc10b8697fe918061fcecce7056b0e54fbb7
+  metadata.gz: 6b2001d1f6e7653df296a0443a0a2f2bec80068ca05b4693bfd2b74c5f6a5240
+  data.tar.gz: 4f8e3920b836feb38237cd828a11ab63589855391f21cbea90eee6a54a34be9f
 SHA512:
-  metadata.gz: 1128d0e53047f9cef7fca4111dabf95306cd98e06c83c539816838b3b7f21a75f84e45a0fdf111484bec7a17d91e56ad2c3c75254a2b40314a5c81d1d759cc3a
-  data.tar.gz: 506950f2200002e07101641e65282eae9018716f31a49fe1048ca83f87a7b759c403b2ffa1051183217d8fa9155ae9d98f06bd997d142439f2a5dd63145c728c
+  metadata.gz: 245ff54545cf04f3d0db0062ab51ae2e1dc001a474c45c05e7e7cde21e8a00a523813b5019b96acaba0665010b6a6d31b7922141cb01a4203a2850f10fe5ad56
+  data.tar.gz: dffaa23979af2e85fffb8b0d3b8b3d8688aee1ff7c6d53eeeb5c151c81836380e93921eb5c37e2f2acf7d633a2f73e02a007e0c70af59a01e68f0bcb31a87f99

data/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [0.3.0] - 2026-04-23
+
+### Added
+- `teems meeting --audio` - Download audio-only M4A alongside or instead of video (ideal for transcription)
+- `teems meeting --no-video` - Skip the video download for audio-only output
+- `teems ooo` now supports timed schedules via `--start`/`--end` (e.g., "today 14:00") in addition to all-day dates
+- `teems ooo --invite` - Override the configured notify list for a single invocation
+
+### Changed
+- Recording, audio, and transcript files share a common base name derived from the SharePoint file (e.g., `2026-01-20 - Team Sync.mp4`/`.m4a`/`.vtt`)
+
+### Fixed
+- `teems meeting` shows call duration once on the event header instead of repeating it per participant
+
+## [0.2.0] - 2026-04-14
+
+### Added
+- `teems meeting` - View meeting details, download transcripts, and download recordings
+- Auto-authentication when tokens are missing or expired (no manual `auth login` needed)
+
+### Fixed
+- `teems cal delete` now uses configured endpoints instead of hardcoded defaults
+
 ## [0.1.0] - 2026-04-10
 
 ### Added

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/cal.rb

@@ -477,56 +477,6 @@ module Teems
       end
     end
 
-    # Time parsing for create subcommand
-    module CalTimeParsing
-      private
-
-      def parse_time_input(raw)
-        date, time_str = split_time_input(raw)
-        return unless time_str
-
-        date.is_a?(String) ? parse_absolute_time(date, time_str) : parse_relative_time(date, time_str)
-      end
-
-      def split_time_input(raw)
-        base = Date.today
-        split_tomorrow_time(raw, base) || split_today_time(raw, base) || split_absolute_time(raw)
-      end
-
-      def split_tomorrow_time(raw, base)
-        return unless raw.start_with?('tomorrow ')
-
-        [base + 1, raw.delete_prefix('tomorrow ')]
-      end
-
-      def split_today_time(raw, base)
-        return unless raw.match?(/\A(?:today\s+)?\d{1,2}:\d{2}\z/)
-
-        [base, raw.delete_prefix('today ')]
-      end
-
-      def split_absolute_time(raw)
-        return unless raw.match?(/\A\d{4}-\d{2}-\d{2}\s+\d{1,2}:\d{2}\z/)
-
-        raw.split(/\s+/, 2)
-      end
-
-      def parse_relative_time(date, time_str)
-        hour, min = time_str.split(':').map(&:to_i)
-        debug("Parsing time #{hour}:#{min} for #{@options[:date]}") if @options[:verbose]
-        Time.new(date.year, date.month, date.day, hour, min, 0)
-      rescue ArgumentError
-        nil
-      end
-
-      def parse_absolute_time(date_str, time_str)
-        date = Date.parse(date_str)
-        parse_relative_time(date, time_str)
-      rescue Date::Error
-        nil
-      end
-    end
-
     # Builds the event body hash fields for create requests
     module CalEventFields
       private
@@ -640,7 +590,7 @@ module Teems
 
     # Event creation subcommand
     module CalCreateActions
-      include CalTimeParsing
+      include Support::TimeParsing
       include CalEventFields
       include CalCreateValidation
 

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"],