ez_logs_agent 0.1.5 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b2d2badd73cb46e12e78d54928f6b2cec5f4a39a93f22f6ecbef5b4767ed200a
-  data.tar.gz: c654639d447550d6c2e59a99c072a60126b8502cf749a5be65988f6bc80649ae
+  metadata.gz: 452e5fb397336daeaccc2f5738be03545e5bd318243f30755d5e5205d1c9d2f6
+  data.tar.gz: 22b04cd9a432fef3006ffb33c4322c188e0d9bb4914fb07487f1a135ada3877c
 SHA512:
-  metadata.gz: 703b6dba6216a3f34db5ce0038fda0e19e0a2cd0aa6de07cea95bcb974bdb3856488dc92601376ac7070d18920032b8e8ea941c998d2dc7835e903fa14d72c94
-  data.tar.gz: 4c44195f6539f48933c7949b936f988738657d44728dc6406cf43b270958b05a107f5cec5ac6b8de3b7265c5ff2dbbf07fe276c99dea1f1f1662a1f61eabd05a
+  metadata.gz: 345f3c6929cf6b88bb6d909c6ada301907ccb2aee852957f8da0b278852033978d5116f6ecd67358b33c50921c4fd82e0c65d2cfa1ebb7304d4b9387f8138617
+  data.tar.gz: b412f7a99fbc624541062f0fc8ab148576f48350fc0c72636938360d7cc6c17974382b6bcb47800224e315666bd91f992fdb6b4d4218f54efb16c06b2140f08a

data/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.6] — 2026-05-24
+
+### Added
+- Optional `actor.principal` sub-field (`{ id:, label? }`) on the wire,
+  carrying the human a `kind: "agent"` or `kind: "hybrid"` actor is
+  acting on behalf of. Drops silently if malformed; existing callers
+  unaffected. Lets the server narrate agent actions as
+  "Claude updated employee, on behalf of Razvan" instead of
+  attributing the change to either party alone.
+
+### Internal
+- Dropped a stray gemspec bump to `sidekiq ~> 8.1` that landed via an
+  auto-merged dependabot PR without re-resolving `Gemfile.lock`. Dev
+  deps are back in sync with the lockfile (`rails ~> 7.0`,
+  `sqlite3 ~> 1.6`, `sidekiq ~> 7.0`); no runtime change for customers.
+
 ## [0.1.5] — 2026-05-17 — security release
 
 ### Security

data/lib/ez_logs_agent/actor_validator.rb

@@ -5,9 +5,15 @@ module EzLogsAgent
   #
   # Actor schema:
   # {
-  #   id: String,               # REQUIRED, stable identifier
-  #   label: String | nil,      # optional, human-readable display
-  #   kind: String | nil        # optional, one of human|agent|system|hybrid
+  #   id: String,                       # REQUIRED, stable identifier
+  #   label: String | nil,              # optional, human-readable display
+  #   kind: String | nil,               # optional, one of human|agent|system|hybrid
+  #   principal: { id:, label? } | nil  # optional, only meaningful when
+  #                                     # kind == "hybrid": the human who
+  #                                     # authorized the agent. Drives the
+  #                                     # "Claude updated employee, on
+  #                                     # behalf of Razvan" framing on the
+  #                                     # server's AiExplainer.
   # }
   #
   # This module ensures actors conform to the expected structure
@@ -46,13 +52,36 @@ module EzLogsAgent
         id = actor[:id] || actor["id"]
         label = actor[:label] || actor["label"]
         kind = actor[:kind] || actor["kind"]
+        principal = actor[:principal] || actor["principal"]
 
         result = { id: id.to_s }
         result[:label] = label.to_s if label
         result[:kind] = kind.to_s if kind && VALID_KINDS.include?(kind.to_s)
+        sanitized_principal = sanitize_principal(principal)
+        result[:principal] = sanitized_principal if sanitized_principal
 
         result
       end
+
+      private
+
+      # Sanitize the optional principal sub-structure. Reuses the same
+      # "id required, label optional" shape as the top-level actor — but
+      # principals are always human, so no `kind` field. Returns nil if
+      # the principal is missing or malformed (we drop silently rather
+      # than rejecting the whole actor; principal is purely advisory).
+      def sanitize_principal(principal)
+        return nil if principal.nil?
+        return nil unless principal.is_a?(Hash)
+
+        id = principal[:id] || principal["id"]
+        return nil if id.nil? || id.to_s.empty?
+
+        result = { id: id.to_s }
+        label = principal[:label] || principal["label"]
+        result[:label] = label.to_s if label
+        result
+      end
     end
   end
 end

data/lib/ez_logs_agent/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EzLogsAgent
-  VERSION = "0.1.5"
+  VERSION = "0.1.6"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ez_logs_agent
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.6
 platform: ruby
 authors:
 - dezsirazvan
 bindir: bin
 cert_chain: []
-date: 2026-05-17 00:00:00.000000000 Z
+date: 2026-05-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: request_store