lex-microsoft_teams 0.6.35 → 0.6.37

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a180c2f6406a210f6d7f76959fd16a2030e0c43d3269901228f7a6464425d456
-  data.tar.gz: 7ea5b4c6a093f23875cc841b18e490c5812654a2bda3faf73a36453345ff4d0f
+  metadata.gz: 850930c48981007e5ba07fb8315bf3f5da8cb9eff02ca11911e3a531b820ca71
+  data.tar.gz: b199dce28d0301f690870ae99e9930a8b178a3842ce6800e3f4fc6d4134943e4
 SHA512:
-  metadata.gz: 4d7cbc835079bdeed837263bfbb98269ed0685223a18c002c2b11e726c85c9f2d141b97a1cb58b1270322ef63766ec5d1ee5de415e84a272bf86e48c5347bd04
-  data.tar.gz: 9e30a76561740ce85410bbf278958a2f7bff53a3dfc9476d10db329b0ee174e0baffeac9bdaec01c0c04784f2922287756c50876555984c02d1f1bf0f25cda52
+  metadata.gz: 998911159c181f88202dcd509fafb838adcbd2f1efd2368297ac20fa86cefdff591481986f7d063a69c5f4ffe3225a254ef70f4f6cc9a3f1e7c43080540bec59
+  data.tar.gz: 33ae5434516d523cf1433f0a387d00646a06ae364714a52fb467403b0e93094b41d42f68daf847f1c052e2845f273c2e8e87d5af43d3a74e6eb7aeeba1fa41f6

data/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 ## [Unreleased]
 
+## [0.7.0] - unreleased
+
+### Added
+- New `Runners::Loop` module with four functions for Microsoft Loop component support via `fluidEmbedCard`:
+  - `create_loop_file` — Creates a new `.loop` file in a user's OneDrive via the Graph API; returns drive item metadata including `webUrl`
+  - `loop_attachment` — Builds the `fluidEmbedCard` + placeholder attachment pair required to embed a Loop component in a Teams message
+  - `post_loop_to_chat` — Posts a Loop component inline into a Teams chat thread
+  - `post_loop_to_channel` — Posts a Loop component inline into a Teams channel thread
+- Requires `Files.ReadWrite` and `Sites.ReadWrite.All` Graph API permissions for `create_loop_file`; `Chat.ReadWrite` and `ChannelMessage.Send` are already required by existing runners
+- **Note:** Programmatic write access to Loop page *content* (Fluid Framework) is not yet available via Microsoft Graph; Loop files must be opened in Teams to initialize the collaborative session
+
+## [0.6.36] - 2026-04-13
+
+### Fixed
+- `TokenCache#load_from_vault` now passes `vault_path` explicitly to `vault_get`, matching the `save_to_vault` pattern (#10)
+
 ## [0.6.35] - 2026-04-09
 
 ### Changed

data/README.md

@@ -113,6 +113,14 @@ gem install lex-microsoft_teams
 - `action_submit` — Create a Submit action
 - `message_attachment` — Wrap a card as a message attachment
 
+### Loop Components
+- `create_loop_file` — Create a new `.loop` file in a user's OneDrive; returns drive item metadata including `webUrl`
+- `loop_attachment` — Build a `fluidEmbedCard` attachment array for embedding an existing Loop component URL in a Teams message
+- `post_loop_to_chat` — Post a Loop component inline into a Teams chat thread
+- `post_loop_to_channel` — Post a Loop component inline into a Teams channel thread
+
+> **Note:** Creating a `.loop` file provisions the OneDrive item; the Fluid Framework collaborative session is initialized by Teams on first open. Programmatic write access to Loop page *content* is not yet available via Microsoft Graph.
+
 ### Bot Framework
 - `send_activity` — Send an activity to a conversation
 - `reply_to_activity` — Reply to an existing activity

data/lib/legion/extensions/microsoft_teams/client.rb

@@ -15,6 +15,7 @@ require 'legion/extensions/microsoft_teams/runners/meetings'
 require 'legion/extensions/microsoft_teams/runners/transcripts'
 require 'legion/extensions/microsoft_teams/runners/people'
 require 'legion/extensions/microsoft_teams/runners/ownership'
+require 'legion/extensions/microsoft_teams/runners/loop'
 
 module Legion
   module Extensions
@@ -37,6 +38,7 @@ module Legion
         include Runners::CacheIngest
         include Runners::People
         include Runners::Ownership
+        include Runners::Loop
 
         attr_reader :opts
 

data/lib/legion/extensions/microsoft_teams/helpers/token_cache.rb

@@ -138,7 +138,7 @@ module Legion
           def load_from_vault
             if vault_available?
               log.info("Loading delegated token from Vault (#{vault_path})")
-              data = vault_get
+              data = vault_get(vault_path)
               if data && data[:access_token]
                 @mutex.synchronize do
                   @delegated_cache = {

data/lib/legion/extensions/microsoft_teams/runners/loop.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+require 'legion/extensions/microsoft_teams/helpers/client'
+
+module Legion
+  module Extensions
+    module MicrosoftTeams
+      module Runners
+        module Loop
+          include Legion::Extensions::MicrosoftTeams::Helpers::Client
+          include Legion::JSON::Helper
+
+          # Creates a new .loop file in the user's OneDrive via the Graph API.
+          # The Fluid Framework collaborative session is initialized by Teams on first open.
+          # Returns the drive item metadata including +webUrl+, which can be passed to
+          # +post_loop_to_chat+ or +post_loop_to_channel+.
+          #
+          # @param filename     [String] Name of the file (e.g. "incident-status" or "incident-status.loop")
+          # @param folder_path  [String] OneDrive folder path relative to root (default: root)
+          # @param user_id      [String] Graph user ID or 'me' (default: 'me')
+          def create_loop_file(filename:, folder_path: nil, user_id: 'me', **)
+            filename = "#{filename}.loop" unless filename.end_with?('.loop')
+
+            path = if folder_path.nil? || folder_path.empty?
+                     "users/#{user_id}/drive/root:/#{filename}:/content"
+                   else
+                     "users/#{user_id}/drive/root:/#{folder_path}/#{filename}:/content"
+                   end
+
+            response = graph_connection(**).put(path, '', 'Content-Type' => 'application/octet-stream')
+            { result: response.body }
+          end
+
+          # Builds the fluidEmbedCard attachment array required to embed a Loop component
+          # in a Teams message. Pass the resulting array as +attachments:+ to
+          # +send_chat_message+ / +send_channel_message+, or use the convenience methods
+          # +post_loop_to_chat+ and +post_loop_to_channel+.
+          #
+          # @param component_url [String] SharePoint/OneDrive URL of the .loop file
+          #                               (the +webUrl+ from +create_loop_file+)
+          # @param source_type   [String] 'Compose' (default) or 'Loop'
+          def loop_attachment(component_url:, source_type: 'Compose', **)
+            attachment_id = SecureRandom.hex(16)
+            {
+              result: [
+                {
+                  id:          attachment_id,
+                  contentType: 'application/vnd.microsoft.card.fluidEmbedCard',
+                  contentUrl:  nil,
+                  content:     json_generate({ componentUrl: component_url, sourceType: source_type }),
+                  teamsAppId:  'FluidEmbedCard'
+                },
+                {
+                  id:          'placeholderCard',
+                  contentType: 'application/vnd.microsoft.card.codesnippet',
+                  content:     '{}',
+                  teamsAppId:  'FLUID_PLACEHOLDER_CARD'
+                }
+              ]
+            }
+          end
+
+          # Posts a message into a Teams chat thread with a Loop component embedded inline.
+          #
+          # @param chat_id       [String] Teams chat thread ID (e.g. 19:...@thread.v2)
+          # @param component_url [String] SharePoint/OneDrive URL of the .loop file
+          # @param body_text     [String] Optional plain-text preamble shown above the component
+          def post_loop_to_chat(chat_id:, component_url:, body_text: '', **)
+            attachments = loop_attachment(component_url: component_url, **)[:result]
+            content     = body_text.empty? ? '<p></p>' : "<p>#{body_text}</p>"
+            payload     = { body: { contentType: 'html', content: content }, attachments: attachments }
+            response    = graph_connection(**).post("chats/#{chat_id}/messages", payload)
+            { result: response.body }
+          end
+
+          # Posts a message into a Teams channel thread with a Loop component embedded inline.
+          #
+          # @param team_id       [String] Teams team ID
+          # @param channel_id    [String] Teams channel ID
+          # @param component_url [String] SharePoint/OneDrive URL of the .loop file
+          # @param body_text     [String] Optional plain-text preamble shown above the component
+          # @param subject       [String] Optional thread subject line
+          def post_loop_to_channel(team_id:, channel_id:, component_url:, body_text: '', subject: nil, **)
+            attachments = loop_attachment(component_url: component_url, **)[:result]
+            content     = body_text.empty? ? '<p></p>' : "<p>#{body_text}</p>"
+            payload     = { body: { contentType: 'html', content: content }, attachments: attachments }
+            payload[:subject] = subject if subject
+            response = graph_connection(**).post("teams/#{team_id}/channels/#{channel_id}/messages", payload)
+            { result: response.body }
+          end
+
+          include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers, false) &&
+                                                      Legion::Extensions::Helpers.const_defined?(:Lex, false)
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/microsoft_teams/version.rb

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module MicrosoftTeams
-      VERSION = '0.6.35'
+      VERSION = '0.6.37'
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-microsoft_teams
 version: !ruby/object:Gem::Version
-  version: 0.6.35
+  version: 0.6.37
 platform: ruby
 authors:
 - Esity
@@ -218,6 +218,7 @@ files:
 - lib/legion/extensions/microsoft_teams/runners/channels.rb
 - lib/legion/extensions/microsoft_teams/runners/chats.rb
 - lib/legion/extensions/microsoft_teams/runners/local_cache.rb
+- lib/legion/extensions/microsoft_teams/runners/loop.rb
 - lib/legion/extensions/microsoft_teams/runners/meetings.rb
 - lib/legion/extensions/microsoft_teams/runners/messages.rb
 - lib/legion/extensions/microsoft_teams/runners/ownership.rb