lex-service_now 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9850b5ae25b0769c3e26b07fac9cbfe6fb6913e718e0eaba29c2a62e42bdc155
-  data.tar.gz: 72b828b004be9fe534c51a677c011a6cbe8d6470f91e7b25912d42b1ee1eb956
+  metadata.gz: 7299f2cb64f753600e58b75350804a51164e4ed0b246a0124e9dd691ae813860
+  data.tar.gz: 4cdb63326d0a106814c0f6abb67bf819198e0114d299dbf971a3185ed3b75f8c
 SHA512:
-  metadata.gz: 6d728a8a52d1178d62eaa70b3d1c90b41a22fff61e9a8dc6916369eeb508e523f16b09c7e12262c8d6dec3c13ad62892ccfbffe6a8dc33ceca56379b26cff5fd
-  data.tar.gz: ae69b9ad088f9f5ed8fb5420cb6dea76eb6c083152af6800af83d74a34c8f32f1d093da9a3ede7b8b6f95ece399f65f8a3c32d3c0e2e380afbf12c59acc37f1b
+  metadata.gz: 619c90c1289c5b046076a55290a5969d51605b5491ad3163a4038de98d99e06294b62774d5a3d24592ec27f0705ab759df3aafca91778be7c6af10f8d0e0d3ea
+  data.tar.gz: 3ee2c4fb6921cf67f71139d9a288d6d056302a0b403f63dcb6b809dfb3667ca00b7689255e5ade8bb188d618a97169338b71673b7c8febb99401ca7e2e493374

data/.rubocop.yml

@@ -28,7 +28,7 @@ Metrics/BlockLength:
     - 'spec/**/*'
 
 Metrics/ParameterLists:
-  Max: 8
+  Max: 12
 
 Naming/MethodParameterName:
   MinNameLength: 2

data/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## [0.2.0] - 2026-04-22
+
+### Added
+- Incident runner (6 methods)
+- Problem runner (6 methods)
+- Attachment runner (5 methods) with multipart upload support
+- Table runner (5 methods) — generic CRUD escape hatch for any table
+- Aggregate runner (1 method) — stats/count/sum/avg queries
+- User runner (7 methods) including lookup by username and email
+- UserGroup runner (9 methods) including member management
+- Request/RITM runner (6 methods)
+- Approval runner (5 methods) — approve, reject, list_for_record
+- Task runner (5 methods) including add_work_note
+- SLA runner (5 methods) — definitions and task SLA tracking
+- ImportSet runner (2 methods)
+- Event runner (3 methods)
+- PerformanceAnalytics runner (5 methods) — widgets, scorecards, indicators
+- Flow/Subflow runner (6 methods)
+- Notification runner (5 methods)
+- EmailLog runner (3 methods)
+- Audit runner (3 methods) — field change history
+- SystemProperty runner (6 methods)
+- Asset runner (6 methods) including hardware
+- Location runner (5 methods)
+- Department runner (5 methods)
+- Company runner (5 methods)
+- Project runner (6 methods) including project tasks
+- Release runner (5 methods)
+- HrCase runner (5 methods)
+- SecurityIncident runner (5 methods)
+- UpdateSet runner (6 methods) including change listing
+- ScriptInclude runner (5 methods)
+- BusinessRule runner (5 methods)
+- ScheduledJob runner (5 methods)
+- OnCall runner (5 methods) — schedules, members, who_is_on_call
+- Survey runner (5 methods) — instances and responses
+- Contract runner (5 methods)
+- CostCenter runner (5 methods)
+- WorkOrder runner (6 methods) including tasks
+- Discovery runner (5 methods)
+- MidServer runner (5 methods)
+- CatalogVariable runner (5 methods)
+- Workflow runner (6 methods) — contexts and cancellation
+- 10 LLM skills: Incident, ChangeRequest, CmdbQuery, Knowledge, ServiceCatalog, ProblemManagement, RequestFulfillment, ApprovalWorkflow, AssetManagement, SecurityIncidentResponse
+
 ## [0.1.0] - 2026-04-22
 
 ### Added

data/CLAUDE.md

@@ -0,0 +1,160 @@
+# lex-service_now: ServiceNow Integration for LegionIO
+
+**Repository Level 3 Documentation**
+- **Parent**: `/Users/miverso2/rubymine/legion/extensions-other/CLAUDE.md`
+- **Grandparent**: `/Users/miverso2/rubymine/legion/CLAUDE.md`
+
+## Purpose
+
+Comprehensive Legion Extension connecting LegionIO to ServiceNow via REST APIs. Covers 46 domains spanning ITSM, ITOM, ITAM, HR, Security, DevOps, and platform administration.
+
+**Version**: 0.2.0
+**GitHub**: https://github.com/LegionIO/lex-service_now
+**License**: MIT
+
+## Architecture
+
+```
+Legion::Extensions::ServiceNow
++-- Helpers/
+|   +-- Client             # connection() with OAuth2→Bearer→Basic auth priority fallback
++-- ITSM/
+|   +-- Change::Runners::Change          (14 methods) — normal/emergency/standard + tasks/conflicts/approvals
+|   +-- Incident::Runners::Incident      (6 methods)  — CRUD + resolve
+|   +-- Problem::Runners::Problem        (6 methods)  — CRUD + close
+|   +-- Request::Runners::Request        (6 methods)  — sc_request + sc_req_item
+|   +-- Approval::Runners::Approval      (5 methods)  — approve/reject + list_for_record
+|   +-- Task::Runners::Task              (5 methods)  — CRUD + add_work_note
+|   +-- Sla::Runners::Sla               (5 methods)  — definitions + task SLAs
++-- CMDB/
+|   +-- Cmdb::Instance::Runners::Instance  (7 methods)  — CI CRUD + relationships
+|   +-- Cmdb::Meta::Runners::Meta          (2 methods)  — hierarchy + class metadata
++-- Knowledge/
+|   +-- Knowledge::Runners::Knowledge      (5 methods)  — article CRUD
++-- ServiceCatalog/
+|   +-- ServiceCatalog::Runners::ServiceCatalog  (11 methods) — catalogs/items/cart/order
+|   +-- CatalogVariable::Runners::CatalogVariable (5 methods) — item variables CRUD
++-- User Management/
+|   +-- User::Runners::User              (7 methods)  — CRUD + lookup_by_username/email
+|   +-- UserGroup::Runners::UserGroup    (9 methods)  — CRUD + member management
+|   +-- Account::Runners::Account        (4 methods)  — core account CRUD
++-- Assets/
+|   +-- Asset::Runners::Asset            (6 methods)  — alm_asset CRUD + hardware
+|   +-- Contract::Runners::Contract      (5 methods)  — ast_contract CRUD
++-- Organization/
+|   +-- Location::Runners::Location      (5 methods)  — cmn_location CRUD
+|   +-- Department::Runners::Department  (5 methods)  — cmn_department CRUD
+|   +-- Company::Runners::Company        (5 methods)  — core_company CRUD
+|   +-- CostCenter::Runners::CostCenter  (5 methods)  — cmn_cost_center CRUD
++-- Project & Release/
+|   +-- Project::Runners::Project        (6 methods)  — pm_project CRUD + tasks
+|   +-- Release::Runners::Release        (5 methods)  — rm_release CRUD
++-- Security/
+|   +-- SecurityIncident::Runners::SecurityIncident  (5 methods) — sn_si_incident CRUD
++-- HR/
+|   +-- HrCase::Runners::HrCase          (5 methods)  — sn_hr_core_case CRUD
++-- Platform Admin/
+|   +-- SystemProperty::Runners::SystemProperty  (6 methods) — sys_properties CRUD
+|   +-- UpdateSet::Runners::UpdateSet    (6 methods)  — CRUD + list changes
+|   +-- ScriptInclude::Runners::ScriptInclude  (5 methods)  — sys_script_include CRUD
+|   +-- BusinessRule::Runners::BusinessRule    (5 methods)  — sys_script CRUD
+|   +-- ScheduledJob::Runners::ScheduledJob    (5 methods)  — sysauto_script CRUD
+|   +-- Workflow::Runners::Workflow       (6 methods)  — wf_workflow + contexts
+|   +-- Flow::Runners::Flow              (6 methods)  — sn_fd flow execute + subflows
+|   +-- Audit::Runners::Audit            (3 methods)  — sys_audit + field changes
++-- ITOM/
+|   +-- Discovery::Runners::Discovery    (5 methods)  — schedules/logs/devices
+|   +-- MidServer::Runners::MidServer    (5 methods)  — ecc_agent CRUD + capabilities
+|   +-- Event::Runners::Event            (3 methods)  — sysevent CRUD
++-- Analytics/
+|   +-- PerformanceAnalytics::Runners::PerformanceAnalytics  (5 methods) — widgets/scorecards/indicators
+|   +-- Aggregate::Runners::Aggregate    (1 method)   — stats queries on any table
++-- Comms/
+|   +-- Notification::Runners::Notification  (5 methods) — sysevent_email_action CRUD
+|   +-- EmailLog::Runners::EmailLog      (3 methods)  — sys_email list/get/list_for_record
++-- Field Service/
+|   +-- WorkOrder::Runners::WorkOrder    (6 methods)  — wm_order CRUD + tasks + close
+|   +-- OnCall::Runners::OnCall          (5 methods)  — cmn_rota + members + who_is_on_call
++-- Utilities/
+|   +-- Table::Runners::Table            (5 methods)  — generic CRUD on any table
+|   +-- ImportSet::Runners::ImportSet    (2 methods)  — /api/now/import
+|   +-- Survey::Runners::Survey          (5 methods)  — assessments + instances + responses
++-- Skills/ (loaded only if legion-llm available)
+|   +-- Incident, ChangeRequest, CmdbQuery, Knowledge, ServiceCatalog
+|   +-- ProblemManagement, RequestFulfillment, ApprovalWorkflow
+|   +-- AssetManagement, SecurityIncidentResponse
++-- Client                 # Standalone client class including all 46 runners
+```
+
+## Authentication
+
+`Helpers::Client#connection` selects auth priority order (most secure first):
+1. **OAuth2** — `client_id` + `client_secret` → client credentials grant → `/oauth_token.do`, token memoized in `@fetch_oauth2_token`
+2. **Bearer** — `token` → `Authorization: Bearer <token>`
+3. **Basic Auth** — `username` + `password` → HTTP Basic
+
+Instance URL defaults to `Legion::Settings[:service_now][:url]`, overridable per `Client.new` or per call.
+
+## Standalone Client
+
+```ruby
+client = Legion::Extensions::ServiceNow::Client.new(
+  url: 'https://your-instance.service-now.com',
+  username: 'svc_account',
+  password: 'secret'
+)
+
+# Or with OAuth2
+client = Legion::Extensions::ServiceNow::Client.new(
+  url: 'https://your-instance.service-now.com',
+  client_id: 'abc',
+  client_secret: 'xyz'
+)
+
+client.list_incidents(sysparm_query: 'state=1', sysparm_limit: 50)
+client.create_change(short_description: 'Deploy v2.0')
+client.get_ci(class_name: 'cmdb_ci_server', sys_id: 'abc123')
+```
+
+## Settings
+
+```json
+{
+  "service_now": {
+    "url": "https://your-instance.service-now.com",
+    "username": null,
+    "password": null,
+    "token": null,
+    "client_id": null,
+    "client_secret": null
+  }
+}
+```
+
+## Dependencies
+
+| Gem | Purpose |
+|-----|---------|
+| `faraday >= 2.0` | HTTP client |
+| `faraday-multipart >= 1.0` | Multipart upload for attachments |
+| `legion-settings >= 1.3.14` | Settings/config |
+| `legion-logging >= 1.3.2` | Structured logging |
+| `legion-cache >= 1.3.11` | Caching |
+| `legion-crypt >= 1.4.9` | Credential encryption |
+| `legion-data >= 1.4.17` | ORM |
+| `legion-json >= 1.2.1` | JSON helpers |
+| `legion-transport >= 1.3.9` | AMQP transport |
+
+`legion-llm` is an optional soft dependency — skills load only if defined.
+
+## Development
+
+```bash
+bundle install
+bundle exec rspec          # 217+ examples, 0 failures
+bundle exec rubocop        # 0 offenses
+```
+
+---
+
+**Maintained By**: Matthew Iverson (@Esity)

data/README.md

@@ -0,0 +1,199 @@
+# lex-service_now
+
+A LegionIO extension connecting Legion to ServiceNow via REST APIs. Covers 46 domains spanning ITSM, ITOM, ITAM, HR, Security, DevOps, and platform administration.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'lex-service_now'
+```
+
+## Configuration
+
+Set credentials via Legion settings (`~/.legionio/settings/service_now.json`):
+
+```json
+{
+  "service_now": {
+    "url": "https://your-instance.service-now.com",
+    "username": "svc_account",
+    "password": "secret"
+  }
+}
+```
+
+OAuth2 and Bearer token auth are also supported — the most secure credentials provided are used automatically (OAuth2 > Bearer > Basic Auth).
+
+## Usage
+
+### Standalone Client
+
+```ruby
+require 'legion/extensions/service_now'
+
+client = Legion::Extensions::ServiceNow::Client.new(
+  url: 'https://your-instance.service-now.com',
+  username: 'admin',
+  password: 'secret'
+)
+
+# Incidents
+client.list_incidents(sysparm_query: 'state=1^priority=1', sysparm_limit: 10)
+client.create_incident(short_description: 'Production server down', urgency: '1', impact: '1')
+client.resolve_incident(sys_id: 'abc123', close_code: 'Solved (Permanently)', close_notes: 'Fixed')
+
+# Change Management
+client.create_normal(short_description: 'Deploy app v2.0', assignment_group: 'CAB Approval')
+client.get_change(id: 'CHG0012345')
+client.get_approvals(id: 'CHG0012345')
+
+# CMDB
+client.list_cis(class_name: 'cmdb_ci_server', sysparm_query: 'operational_status=1')
+client.get_relationships(class_name: 'cmdb_ci_server', sys_id: 'srv001')
+
+# Service Catalog
+client.list_items(catalog_id: 'cat1')
+client.order_now(sys_id: 'item_id', quantity: 1, variables: { justification: 'Project work' })
+
+# Users & Groups
+client.get_user_by_email(email: 'jdoe@company.com')
+client.list_group_members(group_sys_id: 'network_team_id')
+
+# Generic Table API (escape hatch for any table)
+client.table_list(table_name: 'u_custom_table', sysparm_query: 'active=true')
+```
+
+## Supported Domains
+
+### ITSM
+| Domain | Methods | Table |
+|--------|---------|-------|
+| Change | 14 | `sn_chg_rest` API |
+| Incident | 6 | `incident` |
+| Problem | 6 | `problem` |
+| Request/RITM | 6 | `sc_request`, `sc_req_item` |
+| Approval | 5 | `sysapproval_approver` |
+| Task | 5 | `task` |
+| SLA | 5 | `contract_sla`, `task_sla` |
+
+### CMDB & Discovery
+| Domain | Methods | Table |
+|--------|---------|-------|
+| CMDB Instance | 7 | `/api/now/cmdb/instance` |
+| CMDB Meta | 2 | `/api/now/doc/meta` |
+| Discovery | 5 | `discovery_schedule`, `discovery_log` |
+| MID Server | 5 | `ecc_agent` |
+
+### Service Catalog
+| Domain | Methods | Table |
+|--------|---------|-------|
+| Service Catalog | 11 | `/api/sn_sc/servicecatalog` |
+| Catalog Variable | 5 | `item_option_new` |
+
+### Knowledge & Content
+| Domain | Methods | Table |
+|--------|---------|-------|
+| Knowledge | 5 | `/api/sn_km_api/knowledge` |
+| Survey | 5 | `survey`, `asmt_assessment_instance` |
+
+### User & Organization
+| Domain | Methods | Table |
+|--------|---------|-------|
+| User | 7 | `sys_user` |
+| UserGroup | 9 | `sys_user_group`, `sys_user_grmember` |
+| Account | 4 | `account` |
+| Location | 5 | `cmn_location` |
+| Department | 5 | `cmn_department` |
+| Company | 5 | `core_company` |
+| Cost Center | 5 | `cmn_cost_center` |
+
+### Asset & Contract Management
+| Domain | Methods | Table |
+|--------|---------|-------|
+| Asset | 6 | `alm_asset`, `alm_hardware` |
+| Contract | 5 | `ast_contract` |
+
+### Security
+| Domain | Methods | Table |
+|--------|---------|-------|
+| Security Incident | 5 | `sn_si_incident` |
+
+### HR
+| Domain | Methods | Table |
+|--------|---------|-------|
+| HR Case | 5 | `sn_hr_core_case` |
+
+### Project & Release
+| Domain | Methods | Table |
+|--------|---------|-------|
+| Project | 6 | `pm_project`, `pm_project_task` |
+| Release | 5 | `rm_release` |
+
+### Platform Administration
+| Domain | Methods | Table |
+|--------|---------|-------|
+| System Property | 6 | `sys_properties` |
+| Update Set | 6 | `sys_update_set`, `sys_update_xml` |
+| Script Include | 5 | `sys_script_include` |
+| Business Rule | 5 | `sys_script` |
+| Scheduled Job | 5 | `sysauto_script` |
+| Workflow | 6 | `wf_workflow`, `wf_context` |
+| Flow/Subflow | 6 | `/api/sn_fd` |
+| Audit | 3 | `sys_audit` |
+
+### ITOM & Monitoring
+| Domain | Methods | Table |
+|--------|---------|-------|
+| Event | 3 | `sysevent` |
+| Performance Analytics | 5 | `/api/now/pa` |
+
+### Communications
+| Domain | Methods | Table |
+|--------|---------|-------|
+| Notification | 5 | `sysevent_email_action` |
+| Email Log | 3 | `sys_email` |
+
+### Field Service
+| Domain | Methods | Table |
+|--------|---------|-------|
+| Work Order | 6 | `wm_order`, `wm_task` |
+| On-Call | 5 | `cmn_rota`, `cmn_rota_member` |
+
+### Utilities
+| Domain | Methods | Table |
+|--------|---------|-------|
+| Table (generic) | 5 | Any table via `/api/now/table/{table}` |
+| Import Set | 2 | `/api/now/import` |
+| Aggregate | 1 | `/api/now/stats/{table}` |
+| Attachment | 5 | `/api/now/attachment` |
+
+## LLM Skills
+
+When `legion-llm` is available, 10 workflow skills are registered automatically:
+
+| Skill | Trigger Words |
+|-------|--------------|
+| `servicenow:incident` | incident, INC, outage, p1, sev1 |
+| `servicenow:change_request` | CHG, RFC, change request, CAB |
+| `servicenow:cmdb_query` | CMDB, CI, configuration item |
+| `servicenow:knowledge` | KB, knowledge base, article |
+| `servicenow:service_catalog` | catalog, service request, order |
+| `servicenow:problem_management` | PRB, problem, root cause, RCA |
+| `servicenow:request_fulfillment` | RITM, request item, fulfillment |
+| `servicenow:approval_workflow` | approval, approve, reject |
+| `servicenow:asset_management` | asset, hardware, inventory, ALM |
+| `servicenow:security_incident_response` | SIR, security incident, breach |
+
+## Development
+
+```bash
+bundle install
+bundle exec rspec        # 217 examples, 0 failures
+bundle exec rubocop      # 0 offenses
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

data/lex-service_now.gemspec

@@ -25,6 +25,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.add_dependency 'faraday',            '>= 2.0'
+  spec.add_dependency 'faraday-multipart',  '>= 1.0'
   spec.add_dependency 'legion-cache',       '>= 1.3.11'
   spec.add_dependency 'legion-crypt',       '>= 1.4.9'
   spec.add_dependency 'legion-data',        '>= 1.4.17'

data/lib/legion/extensions/service_now/access_control/runners/access_control.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module ServiceNow
+      module AccessControl
+        module Runners
+          module AccessControl
+            include Legion::Extensions::ServiceNow::Helpers::Client
+
+            def list_acls(sysparm_limit: 100, sysparm_offset: 0,
+                          sysparm_query: nil, **)
+              params = { sysparm_limit: sysparm_limit, sysparm_offset: sysparm_offset }
+              params[:sysparm_query] = sysparm_query if sysparm_query
+              resp = connection(**).get('/api/now/table/sys_security_acl', params)
+              { acls: resp.body['result'] }
+            end
+
+            def get_acl(sys_id:, **)
+              resp = connection(**).get("/api/now/table/sys_security_acl/#{sys_id}")
+              { acl: resp.body['result'] }
+            end
+
+            def create_acl(name:, type:, operation:, active: true,
+                           script: nil, condition: nil, **)
+              body = { name: name, type: type, operation: operation, active: active }
+              body[:script]    = script if script
+              body[:condition] = condition if condition
+              resp = connection(**).post('/api/now/table/sys_security_acl', body)
+              { acl: resp.body['result'] }
+            end
+
+            def update_acl(sys_id:, active: nil, script: nil, condition: nil, **)
+              body = {}
+              body[:active]    = active unless active.nil?
+              body[:script]    = script if script
+              body[:condition] = condition if condition
+              resp = connection(**).patch("/api/now/table/sys_security_acl/#{sys_id}", body)
+              { acl: resp.body['result'] }
+            end
+
+            def delete_acl(sys_id:, **)
+              resp = connection(**).delete("/api/now/table/sys_security_acl/#{sys_id}")
+              { deleted: resp.status == 204, sys_id: sys_id }
+            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
+end

data/lib/legion/extensions/service_now/aggregate/runners/aggregate.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module ServiceNow
+      module Aggregate
+        module Runners
+          module Aggregate
+            include Legion::Extensions::ServiceNow::Helpers::Client
+
+            def aggregate(table_name:, sysparm_count: nil, sysparm_sum_fields: nil,
+                          sysparm_avg_fields: nil, sysparm_min_fields: nil,
+                          sysparm_max_fields: nil, sysparm_query: nil,
+                          sysparm_group_by: nil, sysparm_having: nil, **)
+              params = {}
+              params[:sysparm_count]       = sysparm_count unless sysparm_count.nil?
+              params[:sysparm_sum_fields]  = sysparm_sum_fields if sysparm_sum_fields
+              params[:sysparm_avg_fields]  = sysparm_avg_fields if sysparm_avg_fields
+              params[:sysparm_min_fields]  = sysparm_min_fields if sysparm_min_fields
+              params[:sysparm_max_fields]  = sysparm_max_fields if sysparm_max_fields
+              params[:sysparm_query]       = sysparm_query if sysparm_query
+              params[:sysparm_group_by]    = sysparm_group_by if sysparm_group_by
+              params[:sysparm_having]      = sysparm_having if sysparm_having
+              resp = connection(**).get("/api/now/stats/#{table_name}", params)
+              { stats: resp.body['result'] }
+            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
+end

data/lib/legion/extensions/service_now/approval/runners/approval.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module ServiceNow
+      module Approval
+        module Runners
+          module Approval
+            include Legion::Extensions::ServiceNow::Helpers::Client
+
+            def list_approvals(sysparm_limit: 100, sysparm_offset: 0, sysparm_query: nil, **)
+              params = { sysparm_limit: sysparm_limit, sysparm_offset: sysparm_offset }
+              params[:sysparm_query] = sysparm_query if sysparm_query
+              resp = connection(**).get('/api/now/table/sysapproval_approver', params)
+              { approvals: resp.body['result'] }
+            end
+
+            def get_approval(sys_id:, **)
+              resp = connection(**).get("/api/now/table/sysapproval_approver/#{sys_id}")
+              { approval: resp.body['result'] }
+            end
+
+            def approve(sys_id:, comments: nil, **)
+              body = { state: 'approved' }
+              body[:comments] = comments if comments
+              resp = connection(**).patch("/api/now/table/sysapproval_approver/#{sys_id}", body)
+              { approval: resp.body['result'] }
+            end
+
+            def reject(sys_id:, comments: nil, **)
+              body = { state: 'rejected' }
+              body[:comments] = comments if comments
+              resp = connection(**).patch("/api/now/table/sysapproval_approver/#{sys_id}", body)
+              { approval: resp.body['result'] }
+            end
+
+            def list_approvals_for_record(document_id:, **)
+              params = { sysparm_query: "document_id=#{document_id}", sysparm_limit: 100 }
+              resp = connection(**).get('/api/now/table/sysapproval_approver', params)
+              { approvals: resp.body['result'] }
+            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
+end

data/lib/legion/extensions/service_now/asset/runners/asset.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module ServiceNow
+      module Asset
+        module Runners
+          module Asset
+            include Legion::Extensions::ServiceNow::Helpers::Client
+
+            def list_assets(sysparm_limit: 100, sysparm_offset: 0, sysparm_query: nil,
+                            sysparm_fields: nil, **)
+              params = { sysparm_limit: sysparm_limit, sysparm_offset: sysparm_offset }
+              params[:sysparm_query]  = sysparm_query if sysparm_query
+              params[:sysparm_fields] = sysparm_fields if sysparm_fields
+              resp = connection(**).get('/api/now/table/alm_asset', params)
+              { assets: resp.body['result'] }
+            end
+
+            def get_asset(sys_id:, **)
+              resp = connection(**).get("/api/now/table/alm_asset/#{sys_id}")
+              { asset: resp.body['result'] }
+            end
+
+            def create_asset(model:, model_category:, serial_number: nil,
+                             assigned_to: nil, state: nil, **)
+              body = { model: model, model_category: model_category }
+              body[:serial_number] = serial_number if serial_number
+              body[:assigned_to]   = assigned_to if assigned_to
+              body[:state]         = state if state
+              resp = connection(**).post('/api/now/table/alm_asset', body)
+              { asset: resp.body['result'] }
+            end
+
+            def update_asset(sys_id:, state: nil, assigned_to: nil,
+                             location: nil, serial_number: nil, **)
+              body = {}
+              body[:state]         = state if state
+              body[:assigned_to]   = assigned_to if assigned_to
+              body[:location]      = location if location
+              body[:serial_number] = serial_number if serial_number
+              resp = connection(**).patch("/api/now/table/alm_asset/#{sys_id}", body)
+              { asset: resp.body['result'] }
+            end
+
+            def delete_asset(sys_id:, **)
+              resp = connection(**).delete("/api/now/table/alm_asset/#{sys_id}")
+              { deleted: resp.status == 204, sys_id: sys_id }
+            end
+
+            def list_hardware(sysparm_limit: 100, sysparm_offset: 0, sysparm_query: nil, **)
+              params = { sysparm_limit: sysparm_limit, sysparm_offset: sysparm_offset }
+              params[:sysparm_query] = sysparm_query if sysparm_query
+              resp = connection(**).get('/api/now/table/alm_hardware', params)
+              { hardware: resp.body['result'] }
+            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
+end