Module: Legion::LLM::API::Namespaces::Registration

Extended by:
Legion::Logging::Helper
Defined in:
lib/legion/llm/api/namespaces/registration.rb

Class Method Summary collapse

Class Method Details

.register_anthropic(app) ⇒ Object



162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
# File 'lib/legion/llm/api/namespaces/registration.rb', line 162

def self.register_anthropic(app)
  require_relative 'anthropic/messages'
  require_relative 'anthropic/messages/count_tokens'
  require_relative 'anthropic/messages/batches'
  require_relative 'anthropic/files'
  # NOTE: anthropic/models.rb is a format helper only — no routes to register.
  # The /v1/models namespace is owned by OpenAI::Models (Phase 2A) which branches
  # on anthropic_client?(env) to emit Anthropic-format responses.

  app.namespace '/v1/messages' do
    register Namespaces::Anthropic::Messages
    register Namespaces::Anthropic::Messages::CountTokens
    namespace('/batches') { register Namespaces::Anthropic::Messages::Batches }
  end

  # NOTE: /v1/files is owned by OpenAI::Files (registered first).
  # Anthropic::Files is available for standalone Anthropic-only deployments
  # but is NOT mounted here to avoid route conflicts. When both protocols
  # are active, OpenAI::Files handles /v1/files for all clients.
  # detect_client(env) branching for file ID format is a future enhancement.

  log.debug('[llm][api][namespaces] anthropic namespaces registered')
end

.register_native(app) ⇒ Object



27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
# File 'lib/legion/llm/api/namespaces/registration.rb', line 27

def self.register_native(app)
  log.debug('[llm][api][namespaces] registering native routes')

  require_relative 'native/providers'
  require_relative 'native/instances'
  require_relative 'native/models'
  require_relative 'native/offerings'
  require_relative 'native/routing'
  require_relative 'native/tiers'
  require_relative 'native/chat'
  require_relative 'native/inference'

  app.namespace '/api/llm/providers' do
    register Namespaces::Native::Providers
  end

  app.namespace '/api/llm/instances' do
    register Namespaces::Native::Instances
  end

  app.namespace '/api/llm/models' do
    register Namespaces::Native::Models
  end

  # Cross-namespace route: /api/llm/providers/:name/models
  # Must be registered at full path, not inside either namespace
  app.get '/api/llm/providers/:name/models' do
    provider = params[:name]
    log.debug("[llm][api][namespaces][models] action=list_provider_models provider=#{provider}")
    require_llm!

    filters = Legion::LLM::API::Native::Models.request_filters(params).merge(provider: provider)
    offerings = Legion::LLM::Inventory.offerings(filters)

    json_response({
                    provider:  provider,
                    models:    Legion::LLM::API::Native::Models.model_summaries(offerings),
                    offerings: offerings,
                    summary:   Legion::LLM::API::Native::Models.summary(offerings)
                  })
  rescue StandardError => e
    handle_exception(e, level: :error, handled: true, operation: 'llm.api.models.provider')
    json_error('model_inventory_error', e.message, status_code: 500)
  end

  app.namespace '/api/llm/offerings' do
    register Namespaces::Native::Offerings
  end

  app.namespace '/api/llm/routing' do
    register Namespaces::Native::Routing
  end

  app.namespace '/api/llm/tiers' do
    register Namespaces::Native::Tiers
  end

  app.namespace '/api/llm/chat' do
    register Namespaces::Native::Chat
  end

  app.namespace '/api/llm/inference' do
    register Namespaces::Native::Inference
  end

  log.debug('[llm][api][namespaces] native routes registered')
end

.register_openai(app) ⇒ Object



95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
# File 'lib/legion/llm/api/namespaces/registration.rb', line 95

def self.register_openai(app)
  log.debug('[llm][api][namespaces] registering openai namespaces')

  require_relative 'openai/responses'
  require_relative 'openai/chat/completions'
  require_relative 'openai/chat/messages'
  require_relative 'openai/models'
  require_relative 'openai/embeddings'
  require_relative 'openai/completions'
  require_relative 'openai/moderations'

  app.register OpenAI::Responses
  app.register OpenAI::Chat::Completions
  app.register OpenAI::Chat::Messages
  app.register OpenAI::Models
  app.register OpenAI::Embeddings
  app.register OpenAI::Completions
  app.register OpenAI::Moderations

  require_relative 'openai/conversations'
  require_relative 'openai/conversations/items'
  require_relative 'openai/batches'
  require_relative 'openai/files'
  require_relative 'openai/uploads'
  require_relative 'openai/uploads/parts'

  app.register OpenAI::Conversations
  app.register OpenAI::Conversations::Items
  app.register OpenAI::Batches
  app.register OpenAI::Files
  app.register OpenAI::Uploads
  app.register OpenAI::Uploads::Parts

  require_relative 'openai/images'
  require_relative 'openai/audio/transcriptions'
  require_relative 'openai/audio/translations'
  require_relative 'openai/audio/speech'

  app.namespace '/v1/images' do
    register Namespaces::OpenAI::Images
  end

  app.namespace '/v1/audio' do
    namespace('/transcriptions') { register Namespaces::OpenAI::Audio::Transcriptions }
    namespace('/translations')   { register Namespaces::OpenAI::Audio::Translations }
    namespace('/speech')         { register Namespaces::OpenAI::Audio::Speech }
  end

  require_relative 'openai/vector_stores'
  require_relative 'openai/vector_stores/files'
  require_relative 'openai/vector_stores/file_batches'

  app.helpers Namespaces::OpenAI::VectorStores
  app.helpers Namespaces::OpenAI::VectorStores::Files
  app.helpers Namespaces::OpenAI::VectorStores::FileBatches

  app.namespace '/v1/vector_stores' do
    register Namespaces::OpenAI::VectorStores
  end
  app.namespace '/v1/vector_stores/:vector_store_id' do
    register Namespaces::OpenAI::VectorStores::Files
    register Namespaces::OpenAI::VectorStores::FileBatches
  end

  log.debug('[llm][api][namespaces] openai namespaces registered')
end

.registered(app) ⇒ Object



15
16
17
18
19
20
21
22
23
24
25
# File 'lib/legion/llm/api/namespaces/registration.rb', line 15

def self.registered(app)
  log.debug('[llm][api][namespaces] registering namespace routes')
  app.register Sinatra::Namespace
  app.helpers Helpers

  register_native(app)
  register_openai(app)
  register_anthropic(app)

  log.debug('[llm][api][namespaces] all namespace routes registered')
end