rapitapir 0.1.2 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (161) hide show
  1. checksums.yaml +4 -4
  2. data/.rubocop.yml +7 -7
  3. data/.rubocop_todo.yml +88 -0
  4. data/CHANGELOG.md +29 -1
  5. data/README.md +1339 -236
  6. data/RUBY_WEEKLY_LAUNCH_POST.md +200 -0
  7. data/docs/RAILS_INTEGRATION_IMPLEMENTATION.md +209 -0
  8. data/docs/SINATRA_EXTENSION.md +399 -348
  9. data/docs/STRICT_VALIDATION.md +229 -0
  10. data/docs/VALIDATION_IMPROVEMENTS.md +218 -0
  11. data/docs/adr/0001-base-class-strategy.md +33 -0
  12. data/docs/adr/0002-type-shortcut-and-type-system.md +30 -0
  13. data/docs/adr/0003-openapi-source-of-truth.md +32 -0
  14. data/docs/adr/0004-client-generation-typescript-first.md +34 -0
  15. data/docs/adr/0005-auth-architecture.md +32 -0
  16. data/docs/adr/0006-observability-defaults.md +30 -0
  17. data/docs/adr/0007-ai-scope-and-boundaries.md +30 -0
  18. data/docs/adr/README.md +46 -0
  19. data/docs/adr/template.md +24 -0
  20. data/docs/ai-integration-plan.md +112 -0
  21. data/docs/auto-derivation.md +505 -92
  22. data/docs/blueprint.md +92 -4
  23. data/docs/endpoint-definition.md +536 -129
  24. data/docs/implementation-status.md +1 -1
  25. data/docs/n8n-integration.md +212 -0
  26. data/docs/observability.md +810 -500
  27. data/docs/using-mcp.md +93 -0
  28. data/examples/ai/knowledge_base_rag.rb +83 -0
  29. data/examples/ai/user_management_mcp.rb +92 -0
  30. data/examples/ai/user_validation_llm.rb +187 -0
  31. data/examples/auto_derivation_ruby_friendly.rb +44 -113
  32. data/examples/cli/user_api_endpoints.rb +63 -36
  33. data/examples/demo_api.rb +57 -18
  34. data/examples/enterprise_extension_demo.rb +13 -13
  35. data/examples/enterprise_rapitapir_api.rb +81 -93
  36. data/examples/nocodb/nocodb_scaffold/Gemfile +22 -0
  37. data/examples/nocodb/nocodb_scaffold/README.md +10 -0
  38. data/examples/nocodb/nocodb_scaffold/Rakefile +7 -0
  39. data/examples/nocodb/nocodb_scaffold/app/api/app.rb +1139 -0
  40. data/examples/nocodb/nocodb_scaffold/app/models/email_template.rb +6 -0
  41. data/examples/nocodb/nocodb_scaffold/app/models/faq.rb +6 -0
  42. data/examples/nocodb/nocodb_scaffold/app/models/feature.rb +6 -0
  43. data/examples/nocodb/nocodb_scaffold/app/models/idea.rb +6 -0
  44. data/examples/nocodb/nocodb_scaffold/app/models/itinerary_day.rb +6 -0
  45. data/examples/nocodb/nocodb_scaffold/app/models/route.rb +6 -0
  46. data/examples/nocodb/nocodb_scaffold/app/models/subscriber.rb +6 -0
  47. data/examples/nocodb/nocodb_scaffold/app/models/tour.rb +6 -0
  48. data/examples/nocodb/nocodb_scaffold/app/models/webhook.rb +6 -0
  49. data/examples/nocodb/nocodb_scaffold/app/models_loader.rb +3 -0
  50. data/examples/nocodb/nocodb_scaffold/config/database.yml +11 -0
  51. data/examples/nocodb/nocodb_scaffold/config.ru +9 -0
  52. data/examples/nocodb/nocodb_scaffold/db/migrate/20250808152012_create_features.rb +10 -0
  53. data/examples/nocodb/nocodb_scaffold/db/migrate/20250808152013_create_tours.rb +10 -0
  54. data/examples/nocodb/nocodb_scaffold/db/migrate/20250808152014_create_routes.rb +10 -0
  55. data/examples/nocodb/nocodb_scaffold/db/migrate/20250808152015_create_itinerary_days.rb +10 -0
  56. data/examples/nocodb/nocodb_scaffold/db/migrate/20250808152016_create_subscribers.rb +10 -0
  57. data/examples/nocodb/nocodb_scaffold/db/migrate/20250808152017_create_email_templates.rb +10 -0
  58. data/examples/nocodb/nocodb_scaffold/db/migrate/20250808152018_create_faqs.rb +10 -0
  59. data/examples/nocodb/nocodb_scaffold/db/migrate/20250808152019_create_webhooks.rb +10 -0
  60. data/examples/nocodb/nocodb_scaffold/db/migrate/20250808152020_create_ideas.rb +10 -0
  61. data/examples/nocodb/swagger.json +4378 -0
  62. data/examples/production_ready_example.rb +78 -58
  63. data/examples/rails/RAILS_8_GUIDE.md +165 -0
  64. data/examples/rails/RAILS_LOADING_FIX.rb +35 -0
  65. data/examples/rails/README.md +497 -0
  66. data/examples/rails/comprehensive_test.rb +91 -0
  67. data/examples/rails/config/routes.rb +48 -0
  68. data/examples/rails/debug_controller.rb +63 -0
  69. data/examples/rails/detailed_test.rb +46 -0
  70. data/examples/rails/enhanced_users_controller.rb +278 -0
  71. data/examples/rails/final_server_test.rb +50 -0
  72. data/examples/rails/hello_world_app.rb +116 -0
  73. data/examples/rails/hello_world_controller.rb +186 -0
  74. data/examples/rails/hello_world_routes.rb +28 -0
  75. data/examples/rails/rails8_minimal_demo.rb +132 -0
  76. data/examples/rails/rails8_simple_demo.rb +140 -0
  77. data/examples/rails/rails8_working_demo.rb +255 -0
  78. data/examples/rails/real_world_blog_api.rb +510 -0
  79. data/examples/rails/server_test.rb +46 -0
  80. data/examples/rails/test_direct_processing.rb +41 -0
  81. data/examples/rails/test_hello_world.rb +80 -0
  82. data/examples/rails/test_rails_integration.rb +54 -0
  83. data/examples/rails/traditional_app/Gemfile +37 -0
  84. data/examples/rails/traditional_app/README.md +265 -0
  85. data/examples/rails/traditional_app/app/controllers/api/v1/posts_controller.rb +254 -0
  86. data/examples/rails/traditional_app/app/controllers/api/v1/users_controller.rb +220 -0
  87. data/examples/rails/traditional_app/app/controllers/application_controller.rb +86 -0
  88. data/examples/rails/traditional_app/app/controllers/application_controller_simplified.rb +87 -0
  89. data/examples/rails/traditional_app/app/controllers/documentation_controller.rb +149 -0
  90. data/examples/rails/traditional_app/app/controllers/health_controller.rb +42 -0
  91. data/examples/rails/traditional_app/config/routes.rb +25 -0
  92. data/examples/rails/traditional_app/config/routes_best_practice.rb +25 -0
  93. data/examples/rails/traditional_app/config/routes_simplified.rb +36 -0
  94. data/examples/rails/traditional_app_runnable.rb +406 -0
  95. data/examples/rails/users_controller.rb +4 -1
  96. data/examples/serverless/Gemfile +43 -0
  97. data/examples/serverless/QUICKSTART.md +331 -0
  98. data/examples/serverless/README.md +520 -0
  99. data/examples/serverless/aws_lambda_example.rb +307 -0
  100. data/examples/serverless/aws_sam_template.yaml +215 -0
  101. data/examples/serverless/azure_functions_example.rb +407 -0
  102. data/examples/serverless/deploy.rb +204 -0
  103. data/examples/serverless/gcp_cloud_functions_example.rb +367 -0
  104. data/examples/serverless/gcp_function.yaml +23 -0
  105. data/examples/serverless/host.json +24 -0
  106. data/examples/serverless/package.json +32 -0
  107. data/examples/serverless/spec/aws_lambda_spec.rb +196 -0
  108. data/examples/serverless/spec/spec_helper.rb +89 -0
  109. data/examples/serverless/vercel.json +31 -0
  110. data/examples/serverless/vercel_example.rb +404 -0
  111. data/examples/simple_demo_api.rb +40 -7
  112. data/examples/strict_validation_examples.rb +104 -0
  113. data/examples/user_api.rb +130 -132
  114. data/examples/validation_error_examples.rb +173 -0
  115. data/lib/rapitapir/ai/llm_instruction.rb +456 -0
  116. data/lib/rapitapir/ai/mcp.rb +134 -0
  117. data/lib/rapitapir/ai/rag.rb +287 -0
  118. data/lib/rapitapir/ai/rag_middleware.rb +147 -0
  119. data/lib/rapitapir/auth/oauth2.rb +44 -58
  120. data/lib/rapitapir/cli/command.rb +392 -6
  121. data/lib/rapitapir/cli/mcp_export.rb +18 -0
  122. data/lib/rapitapir/cli/scaffold_generator.rb +639 -0
  123. data/lib/rapitapir/cli/validator.rb +3 -7
  124. data/lib/rapitapir/core/endpoint.rb +59 -6
  125. data/lib/rapitapir/core/enhanced_endpoint.rb +3 -7
  126. data/lib/rapitapir/dsl/enhanced_structures.rb +1 -1
  127. data/lib/rapitapir/dsl/fluent_endpoint_builder.rb +53 -0
  128. data/lib/rapitapir/endpoint_registry.rb +47 -0
  129. data/lib/rapitapir/observability/health_check.rb +4 -4
  130. data/lib/rapitapir/observability/logging.rb +10 -10
  131. data/lib/rapitapir/openapi/schema_generator.rb +46 -2
  132. data/lib/rapitapir/schema.rb +2 -2
  133. data/lib/rapitapir/server/enhanced_rack_adapter.rb +11 -8
  134. data/lib/rapitapir/server/middleware.rb +2 -2
  135. data/lib/rapitapir/server/rack_adapter.rb +1 -3
  136. data/lib/rapitapir/server/rails/configuration.rb +77 -0
  137. data/lib/rapitapir/server/rails/controller_base.rb +185 -0
  138. data/lib/rapitapir/server/rails/documentation_helpers.rb +76 -0
  139. data/lib/rapitapir/server/rails/resource_builder.rb +181 -0
  140. data/lib/rapitapir/server/rails/routes.rb +114 -0
  141. data/lib/rapitapir/server/rails_adapter.rb +10 -3
  142. data/lib/rapitapir/server/rails_adapter_class.rb +1 -3
  143. data/lib/rapitapir/server/rails_controller.rb +1 -3
  144. data/lib/rapitapir/server/rails_integration.rb +67 -0
  145. data/lib/rapitapir/server/rails_response_handler.rb +16 -3
  146. data/lib/rapitapir/server/sinatra_adapter.rb +29 -5
  147. data/lib/rapitapir/server/sinatra_integration.rb +4 -4
  148. data/lib/rapitapir/sinatra/extension.rb +2 -2
  149. data/lib/rapitapir/sinatra/oauth2_helpers.rb +34 -40
  150. data/lib/rapitapir/types/array.rb +4 -0
  151. data/lib/rapitapir/types/auto_derivation.rb +4 -20
  152. data/lib/rapitapir/types/datetime.rb +1 -3
  153. data/lib/rapitapir/types/float.rb +2 -6
  154. data/lib/rapitapir/types/hash.rb +40 -2
  155. data/lib/rapitapir/types/integer.rb +4 -12
  156. data/lib/rapitapir/types/object.rb +6 -2
  157. data/lib/rapitapir/types.rb +6 -2
  158. data/lib/rapitapir/version.rb +1 -1
  159. data/lib/rapitapir.rb +5 -3
  160. data/rapitapir.gemspec +3 -2
  161. metadata +142 -8
@@ -0,0 +1,287 @@
1
+ # frozen_string_literal: true
2
+
3
+ # RapiTapir::AI::RAG
4
+ #
5
+ # Provides Retrieval-Augmented Generation (RAG) pipeline support for RapiTapir endpoints.
6
+ #
7
+ # Usage:
8
+ # - Use `.rag_inference(llm:, retrieval:, context_fields:)` in endpoint DSL
9
+ # - Configure LLM and retrieval backends
10
+ # - Process user queries with retrieved context
11
+
12
+ module RapiTapir
13
+ module AI
14
+ module RAG
15
+ # Base class for LLM providers
16
+ class LLMProvider
17
+ def initialize(config = {})
18
+ @config = config
19
+ end
20
+
21
+ def generate(prompt, context = {})
22
+ raise NotImplementedError, 'Subclasses must implement #generate'
23
+ end
24
+ end
25
+
26
+ # OpenAI LLM provider
27
+ class OpenAIProvider < LLMProvider
28
+ def initialize(config = {})
29
+ super
30
+ @api_key = config[:api_key] || ENV.fetch('OPENAI_API_KEY', nil)
31
+ @model = config[:model] || 'gpt-3.5-turbo'
32
+ @base_url = config[:base_url] || 'https://api.openai.com/v1'
33
+ end
34
+
35
+ def generate(prompt, context = {})
36
+ # Mock implementation for now - replace with actual OpenAI API call
37
+ if @api_key && @api_key != 'mock'
38
+ make_openai_request(prompt, context)
39
+ else
40
+ mock_response(prompt, context)
41
+ end
42
+ end
43
+
44
+ private
45
+
46
+ def make_openai_request(prompt, context)
47
+ # This would make actual HTTP request to OpenAI
48
+ # For now, return a mock response
49
+ mock_response(prompt, context)
50
+ end
51
+
52
+ def mock_response(prompt, context)
53
+ "AI Response: Based on the query '#{prompt}' and context #{context.keys.join(', ')}, here is a generated response."
54
+ end
55
+ end
56
+
57
+ # Base class for retrieval backends
58
+ class RetrievalBackend
59
+ def initialize(config = {})
60
+ @config = config
61
+ end
62
+
63
+ def retrieve(query, context_fields = [])
64
+ raise NotImplementedError, 'Subclasses must implement #retrieve'
65
+ end
66
+ end
67
+
68
+ # PostgreSQL retrieval backend
69
+ class PostgresBackend < RetrievalBackend
70
+ def initialize(config = {})
71
+ super
72
+ @connection_config = config[:connection] || {}
73
+ @table = config[:table] || 'documents'
74
+ @search_column = config[:search_column] || 'content'
75
+ end
76
+
77
+ def retrieve(query, context_fields = [])
78
+ # Mock implementation - replace with actual DB query
79
+ mock_retrieval(query, context_fields)
80
+ end
81
+
82
+ private
83
+
84
+ def mock_retrieval(query, context_fields)
85
+ [
86
+ {
87
+ content: "Sample document content related to: #{query}",
88
+ metadata: context_fields.to_h { |field| [field, "sample_#{field}_value"] },
89
+ score: 0.85
90
+ },
91
+ {
92
+ content: "Another relevant document for: #{query}",
93
+ metadata: context_fields.to_h { |field| [field, "another_#{field}_value"] },
94
+ score: 0.72
95
+ }
96
+ ]
97
+ end
98
+ end
99
+
100
+ # Memory/hash-based retrieval backend for testing
101
+ class MemoryBackend < RetrievalBackend
102
+ def initialize(config = {})
103
+ super
104
+ @documents = config[:documents] || []
105
+ end
106
+
107
+ def retrieve(query, _context_fields = [])
108
+ # Simple text matching for demo purposes
109
+ matching_docs = @documents.select do |doc|
110
+ doc[:content]&.downcase&.include?(query.downcase)
111
+ end
112
+
113
+ matching_docs.map.with_index do |doc, index|
114
+ {
115
+ content: doc[:content],
116
+ metadata: doc[:metadata] || {},
117
+ score: 1.0 - (index * 0.1) # Simple scoring
118
+ }
119
+ end
120
+ end
121
+ end
122
+
123
+ # RAG Pipeline orchestrator
124
+ class Pipeline
125
+ attr_reader :llm_provider, :retrieval_backend
126
+
127
+ def initialize(llm:, retrieval:, config: {})
128
+ @llm_provider = create_llm_provider(llm, config[:llm] || {})
129
+ @retrieval_backend = create_retrieval_backend(retrieval, config[:retrieval] || {})
130
+ @config = config
131
+ end
132
+
133
+ def process(query, context_fields: [], user_context: {})
134
+ # Step 1: Retrieve relevant documents
135
+ retrieved_docs = @retrieval_backend.retrieve(query, context_fields)
136
+
137
+ # Step 2: Build context for LLM
138
+ llm_context = build_llm_context(retrieved_docs, user_context, context_fields)
139
+
140
+ # Step 3: Generate response using LLM
141
+ prompt = build_prompt(query, llm_context)
142
+ response = @llm_provider.generate(prompt, llm_context)
143
+
144
+ # Step 4: Return structured result
145
+ {
146
+ answer: response,
147
+ sources: retrieved_docs,
148
+ context: llm_context,
149
+ query: query
150
+ }
151
+ end
152
+
153
+ private
154
+
155
+ def create_llm_provider(type, config)
156
+ case type.to_sym
157
+ when :openai
158
+ OpenAIProvider.new(config)
159
+ else
160
+ raise ArgumentError, "Unknown LLM provider: #{type}"
161
+ end
162
+ end
163
+
164
+ def create_retrieval_backend(type, config)
165
+ case type.to_sym
166
+ when :postgres, :postgresql
167
+ PostgresBackend.new(config)
168
+ when :memory
169
+ MemoryBackend.new(config)
170
+ else
171
+ raise ArgumentError, "Unknown retrieval backend: #{type}"
172
+ end
173
+ end
174
+
175
+ def build_llm_context(retrieved_docs, user_context, context_fields)
176
+ {
177
+ retrieved_documents: retrieved_docs,
178
+ user_context: user_context,
179
+ context_fields: context_fields,
180
+ document_count: retrieved_docs.length
181
+ }
182
+ end
183
+
184
+ def build_prompt(query, context)
185
+ documents_text = context[:retrieved_documents]
186
+ .map { |doc| doc[:content] }
187
+ .join("\n\n")
188
+
189
+ <<~PROMPT
190
+ You are an AI assistant that answers questions based on the provided context.
191
+
192
+ Context Documents:
193
+ #{documents_text}
194
+
195
+ User Question: #{query}
196
+
197
+ Please provide a helpful and accurate answer based on the context provided.
198
+ If the context doesn't contain enough information, say so clearly.
199
+ PROMPT
200
+ end
201
+ end
202
+
203
+ # Rack middleware for handling RAG inference requests
204
+ class Middleware
205
+ def initialize(app)
206
+ @app = app
207
+ end
208
+
209
+ def call(env)
210
+ endpoint = env['rapitapir.endpoint']
211
+
212
+ # Pass through if not a RAG endpoint
213
+ return @app.call(env) unless endpoint&.rag_inference?
214
+
215
+ # Process RAG request
216
+ process_rag_request(env, endpoint)
217
+ end
218
+
219
+ private
220
+
221
+ def process_rag_request(env, endpoint)
222
+ # Parse request body
223
+ request_body = env['rack.input']&.read
224
+ env['rack.input']&.rewind if env['rack.input'].respond_to?(:rewind)
225
+
226
+ query_data = request_body ? JSON.parse(request_body) : {}
227
+ question = query_data['question'] || query_data[:question]
228
+
229
+ # Get RAG config from endpoint
230
+ rag_config = endpoint.metadata[:rag_inference]
231
+
232
+ # Create RAG pipeline
233
+ pipeline = Pipeline.new(
234
+ llm: rag_config[:llm],
235
+ retrieval: rag_config[:retrieval],
236
+ config: rag_config[:config] || {}
237
+ )
238
+
239
+ # Process the query
240
+ result = pipeline.process(
241
+ question,
242
+ context_fields: rag_config[:context_fields] || [],
243
+ user_context: extract_user_context(env)
244
+ )
245
+
246
+ # Return JSON response
247
+ response_body = JSON.generate(
248
+ answer: result[:answer],
249
+ sources: result[:sources],
250
+ metadata: {
251
+ query: result[:query],
252
+ context_fields: result[:context][:context_fields],
253
+ document_count: result[:context][:document_count]
254
+ }
255
+ )
256
+
257
+ [
258
+ 200,
259
+ { 'Content-Type' => 'application/json' },
260
+ [response_body]
261
+ ]
262
+ rescue StandardError => e
263
+ error_response = JSON.generate(
264
+ error: 'RAG processing failed',
265
+ message: e.message
266
+ )
267
+
268
+ [
269
+ 500,
270
+ { 'Content-Type' => 'application/json' },
271
+ [error_response]
272
+ ]
273
+ end
274
+
275
+ def extract_user_context(env)
276
+ # Extract relevant context from request environment
277
+ {
278
+ user_agent: env['HTTP_USER_AGENT'],
279
+ remote_ip: env['REMOTE_ADDR'],
280
+ method: env['REQUEST_METHOD'],
281
+ path: env['PATH_INFO']
282
+ }
283
+ end
284
+ end
285
+ end
286
+ end
287
+ end
@@ -0,0 +1,147 @@
1
+ # frozen_string_literal: true
2
+
3
+ require_relative 'rag'
4
+
5
+ module RapiTapir
6
+ module AI
7
+ module RAG
8
+ # Middleware for handling RAG-enabled endpoints
9
+ # Integrates with RapiTapir server adapters to process RAG requests
10
+ class Middleware
11
+ def initialize(app)
12
+ @app = app
13
+ end
14
+
15
+ def call(env)
16
+ # Check if this is a RAG-enabled endpoint
17
+ endpoint = env['rapitapir.endpoint']
18
+ if endpoint&.rag_inference?
19
+ handle_rag_request(env, endpoint)
20
+ else
21
+ @app.call(env)
22
+ end
23
+ end
24
+
25
+ private
26
+
27
+ def handle_rag_request(env, endpoint)
28
+ # Extract request data
29
+ request_data = extract_request_data(env)
30
+
31
+ # Get the query from the request (assuming it's in the body)
32
+ query = request_data[:question] || request_data[:query] || request_data.values.first
33
+
34
+ # Create RAG pipeline from endpoint configuration
35
+ rag_config = endpoint.rag_config
36
+ pipeline = create_rag_pipeline(rag_config)
37
+
38
+ # Process the query through RAG pipeline
39
+ result = pipeline.process(
40
+ query,
41
+ context_fields: rag_config[:context_fields],
42
+ user_context: extract_user_context(env, rag_config[:context_fields])
43
+ )
44
+
45
+ # Return RAG response
46
+ build_rag_response(result)
47
+ rescue StandardError => e
48
+ build_error_response(e)
49
+ end
50
+
51
+ def extract_request_data(env)
52
+ # Simple JSON parsing - in real implementation would be more robust
53
+ if env['CONTENT_TYPE']&.include?('application/json')
54
+ body = env['rack.input']&.read || '{}'
55
+ env['rack.input']&.rewind
56
+ JSON.parse(body, symbolize_names: true)
57
+ else
58
+ {}
59
+ end
60
+ rescue JSON::ParserError
61
+ {}
62
+ end
63
+
64
+ def extract_user_context(env, context_fields)
65
+ # Extract user context from headers, session, etc.
66
+ context = {}
67
+
68
+ context_fields.each do |field|
69
+ case field
70
+ when :user_id
71
+ context[:user_id] = env['HTTP_X_USER_ID'] || env['HTTP_AUTHORIZATION']&.split&.last
72
+ when :session_id
73
+ context[:session_id] = env['HTTP_X_SESSION_ID']
74
+ when :tenant_id
75
+ context[:tenant_id] = env['HTTP_X_TENANT_ID']
76
+ end
77
+ end
78
+
79
+ context
80
+ end
81
+
82
+ def create_rag_pipeline(config)
83
+ Pipeline.new(
84
+ llm: config[:llm],
85
+ retrieval: config[:retrieval],
86
+ config: config[:config] || {}
87
+ )
88
+ end
89
+
90
+ def build_rag_response(result)
91
+ response_body = {
92
+ answer: result[:answer],
93
+ sources: result[:sources],
94
+ metadata: {
95
+ query: result[:query],
96
+ source_count: result[:sources].length,
97
+ timestamp: Time.now.iso8601
98
+ }
99
+ }
100
+
101
+ [
102
+ 200,
103
+ { 'Content-Type' => 'application/json' },
104
+ [JSON.generate(response_body)]
105
+ ]
106
+ end
107
+
108
+ def build_error_response(error)
109
+ response_body = {
110
+ error: 'RAG processing failed',
111
+ message: error.message,
112
+ timestamp: Time.now.iso8601
113
+ }
114
+
115
+ [
116
+ 500,
117
+ { 'Content-Type' => 'application/json' },
118
+ [JSON.generate(response_body)]
119
+ ]
120
+ end
121
+ end
122
+
123
+ # Helper for mounting RAG endpoints in server adapters
124
+ class EndpointHandler
125
+ def self.handle(endpoint, request_data, user_context = {})
126
+ return nil unless endpoint.rag_inference?
127
+
128
+ rag_config = endpoint.rag_config
129
+ pipeline = Pipeline.new(
130
+ llm: rag_config[:llm],
131
+ retrieval: rag_config[:retrieval],
132
+ config: rag_config[:config] || {}
133
+ )
134
+
135
+ # Extract query from request data
136
+ query = request_data[:question] || request_data[:query] || request_data.to_s
137
+
138
+ pipeline.process(
139
+ query,
140
+ context_fields: rag_config[:context_fields],
141
+ user_context: user_context
142
+ )
143
+ end
144
+ end
145
+ end
146
+ end
147
+ end
@@ -11,20 +11,20 @@ module RapiTapir
11
11
  # Based on the Auth0 Sinatra integration patterns
12
12
  class Auth0Scheme < Schemes::Base
13
13
  attr_reader :domain, :audience, :algorithm, :jwks_cache_ttl
14
-
14
+
15
15
  def jwks_url
16
16
  "https://#{@domain}/.well-known/jwks.json"
17
17
  end
18
18
 
19
19
  def initialize(name = :oauth2_auth0, config = {})
20
- super(name, config)
21
-
20
+ super
21
+
22
22
  @domain = config[:domain] || raise(ArgumentError, 'Auth0 domain is required')
23
23
  @audience = config[:audience] || raise(ArgumentError, 'Auth0 audience is required')
24
24
  @algorithm = config[:algorithm] || 'RS256'
25
25
  @jwks_cache_ttl = config[:jwks_cache_ttl] || 300 # 5 minutes
26
26
  @realm = config[:realm] || 'API'
27
-
27
+
28
28
  # Cache for JWKS to avoid frequent requests
29
29
  @jwks_cache = nil
30
30
  @jwks_cache_time = nil
@@ -35,13 +35,9 @@ module RapiTapir
35
35
  return nil unless auth_header
36
36
 
37
37
  token = extract_bearer_token(auth_header)
38
- if token.nil?
39
- raise AuthenticationError, "Invalid authorization header format"
40
- end
41
-
42
- if token.strip.empty?
43
- raise AuthenticationError, "Token cannot be empty"
44
- end
38
+ raise AuthenticationError, 'Invalid authorization header format' if token.nil?
39
+
40
+ raise AuthenticationError, 'Token cannot be empty' if token.strip.empty?
45
41
 
46
42
  begin
47
43
  decoded_token = validate_auth0_token(token)
@@ -49,7 +45,7 @@ module RapiTapir
49
45
 
50
46
  # Extract user info and scopes from the token
51
47
  payload = decoded_token.first
52
-
48
+
53
49
  create_context(
54
50
  user: extract_user_from_token(payload),
55
51
  scopes: extract_scopes_from_token(payload),
@@ -88,14 +84,14 @@ module RapiTapir
88
84
 
89
85
  def validate_auth0_token(token)
90
86
  require 'jwt' # Ensure JWT gem is available
91
-
87
+
92
88
  jwks = fetch_jwks
93
-
89
+
94
90
  JWT.decode(
95
91
  token,
96
92
  nil,
97
- true,
98
93
  {
94
+ verify_signature: true,
99
95
  algorithm: @algorithm,
100
96
  iss: domain_url,
101
97
  verify_iss: true,
@@ -108,37 +104,33 @@ module RapiTapir
108
104
 
109
105
  def fetch_jwks
110
106
  # Return cached JWKS if still valid
111
- if @jwks_cache && @jwks_cache_time && (Time.now - @jwks_cache_time) < @jwks_cache_ttl
112
- return @jwks_cache
113
- end
107
+ return @jwks_cache if @jwks_cache && @jwks_cache_time && (Time.now - @jwks_cache_time) < @jwks_cache_ttl
114
108
 
115
109
  # Fetch fresh JWKS from Auth0
116
110
  jwks_response = get_jwks_from_auth0
117
-
118
- unless jwks_response.is_a?(Net::HTTPSuccess)
119
- raise AuthenticationError, 'Unable to fetch JWKS from Auth0'
120
- end
111
+
112
+ raise AuthenticationError, 'Unable to fetch JWKS from Auth0' unless jwks_response.is_a?(Net::HTTPSuccess)
121
113
 
122
114
  jwks_data = JSON.parse(jwks_response.body)
123
-
115
+
124
116
  # Cache the JWKS
125
117
  @jwks_cache = { keys: jwks_data['keys'] }
126
118
  @jwks_cache_time = Time.now
127
-
119
+
128
120
  @jwks_cache
129
121
  end
130
122
 
131
123
  def get_jwks_from_auth0
132
124
  jwks_uri = URI("#{base_domain_url}/.well-known/jwks.json")
133
-
125
+
134
126
  http = Net::HTTP.new(jwks_uri.host, jwks_uri.port)
135
127
  http.use_ssl = true
136
128
  http.verify_mode = OpenSSL::SSL::VERIFY_PEER
137
129
  http.read_timeout = 10
138
-
130
+
139
131
  request = Net::HTTP::Get.new(jwks_uri.request_uri)
140
132
  request['User-Agent'] = 'RapiTapir OAuth2 Client'
141
-
133
+
142
134
  http.request(request)
143
135
  end
144
136
 
@@ -166,17 +158,17 @@ module RapiTapir
166
158
  scope_string = payload['scope']
167
159
  return [] unless scope_string
168
160
 
169
- scope_string.split(' ')
161
+ scope_string.split
170
162
  end
171
163
  end
172
164
 
173
165
  # Generic OAuth2 scheme with token introspection support
174
166
  class GenericScheme < Schemes::Base
175
167
  attr_reader :introspection_endpoint, :client_id, :client_secret, :token_cache_ttl
176
-
168
+
177
169
  def initialize(name = :oauth2, config = {})
178
- super(name, config)
179
-
170
+ super
171
+
180
172
  @introspection_endpoint = config[:introspection_endpoint]
181
173
  @client_id = config[:client_id]
182
174
  @client_secret = config[:client_secret]
@@ -184,7 +176,7 @@ module RapiTapir
184
176
  @realm = config[:realm] || 'API'
185
177
  @cache_tokens = config.fetch(:cache_tokens, true)
186
178
  @token_cache_ttl = config[:token_cache_ttl] || 300 # 5 minutes
187
-
179
+
188
180
  # Token cache to avoid repeated introspection calls
189
181
  @token_cache = {} if @cache_tokens
190
182
  end
@@ -198,11 +190,9 @@ module RapiTapir
198
190
 
199
191
  begin
200
192
  token_info = validate_oauth2_token(token)
201
-
193
+
202
194
  # Check if token is active
203
- unless token_info && token_info[:active]
204
- raise AuthenticationError, "Token is not active"
205
- end
195
+ raise AuthenticationError, 'Token is not active' unless token_info && token_info[:active]
206
196
 
207
197
  create_context(
208
198
  user: token_info[:user],
@@ -242,19 +232,17 @@ module RapiTapir
242
232
  # Check cache first
243
233
  if @cache_tokens && @token_cache
244
234
  cached = @token_cache[token]
245
- if cached && (Time.now - cached[:cached_at]) < @token_cache_ttl
246
- return cached[:data]
247
- end
235
+ return cached[:data] if cached && (Time.now - cached[:cached_at]) < @token_cache_ttl
248
236
  end
249
237
 
250
238
  # Validate token
251
239
  token_info = if @introspection_endpoint
252
- introspect_token_via_endpoint(token)
253
- elsif @token_validator
254
- @token_validator.call(token)
255
- else
256
- default_token_validation(token)
257
- end
240
+ introspect_token_via_endpoint(token)
241
+ elsif @token_validator
242
+ @token_validator.call(token)
243
+ else
244
+ default_token_validation(token)
245
+ end
258
246
 
259
247
  # Cache the result
260
248
  if @cache_tokens && @token_cache && token_info
@@ -269,40 +257,38 @@ module RapiTapir
269
257
 
270
258
  def introspect_token_via_endpoint(token)
271
259
  uri = URI(@introspection_endpoint)
272
-
260
+
273
261
  http = Net::HTTP.new(uri.host, uri.port)
274
262
  http.use_ssl = (uri.scheme == 'https')
275
-
263
+
276
264
  request = Net::HTTP::Post.new(uri.request_uri)
277
265
  request['Content-Type'] = 'application/x-www-form-urlencoded'
278
266
  request['Accept'] = 'application/json'
279
-
267
+
280
268
  # Add client authentication
281
269
  if @client_id && @client_secret
282
270
  credentials = Base64.strict_encode64("#{@client_id}:#{@client_secret}")
283
271
  request['Authorization'] = "Basic #{credentials}"
284
272
  end
285
-
273
+
286
274
  # Set form data
287
275
  request.set_form_data(
288
276
  'token' => token,
289
277
  'token_type_hint' => 'access_token'
290
278
  )
291
-
279
+
292
280
  response = http.request(request)
293
-
294
- unless response.is_a?(Net::HTTPSuccess)
295
- raise AuthenticationError, "Token introspection failed: #{response.code} #{response.message}"
296
- end
297
-
281
+
282
+ raise AuthenticationError, "Token introspection failed: #{response.code} #{response.message}" unless response.is_a?(Net::HTTPSuccess)
283
+
298
284
  begin
299
285
  introspection_data = JSON.parse(response.body)
300
286
  rescue JSON::ParserError => e
301
287
  raise AuthenticationError, "Invalid introspection response: #{e.message}"
302
288
  end
303
-
289
+
304
290
  return { active: false } unless introspection_data['active']
305
-
291
+
306
292
  {
307
293
  active: true,
308
294
  user: extract_user_from_introspection(introspection_data),
@@ -324,7 +310,7 @@ module RapiTapir
324
310
 
325
311
  def extract_scopes_from_introspection(data)
326
312
  if data['scope'].is_a?(String)
327
- data['scope'].split(' ')
313
+ data['scope'].split
328
314
  elsif data['scope'].is_a?(Array)
329
315
  data['scope']
330
316
  else