Amr Gharbeia
41de20d3f1
Some checks failed
Deploy (Gitea) / deploy (push) Failing after 11s
- Secret Exposure Gate + Privacy Filter (Bouncer) - Shell actuator safety harness (timeout, blocked patterns) - REPL-first enforcement (lisp validation gate, system-prompt-augment) - Engineering Standards lifecycle (two-track Org-first + REPL-first) - Literate Programming discipline (one function per block, reflect-back) - AGENTS.md: thin routing layer, skills are authoritative - SKILLS_DIR removed, ~/notes fallback eliminated - opencortex.sh: multi-distro (Debian+Fedora), configure, install service, backup, restore, help - infrastructure/opencortex.service (systemd user unit) - Docker: updated to debian:trixie, fixed build context - GitHub CI: lint + test workflows fixed, trigger on tags only - Gitea CI: deploy workflow paths fixed - README: one-line curl install, badges - USER_MANUAL: Deployment section (bare metal, Docker, backup) - .gitignore: skills/*.lisp and tests/*.lisp as generated artifacts - Prose/block refactor across all 35 org files - Test suite Tier 1: 43/45 pass (env-dependent failures isolated)
63 lines
2.7 KiB
Org Mode
63 lines
2.7 KiB
Org Mode
#+TITLE: SKILL: LLM Gateway (org-skill-llm-gateway.org)
|
|
#+AUTHOR: Agent
|
|
#+FILETAGS: :skill:llm:gateway:
|
|
#+PROPERTY: header-args:lisp :tangle org-skill-llm-gateway.lisp
|
|
|
|
* Overview
|
|
The LLM Gateway dispatches inference requests to the registered probabilistic backends. It receives a prompt and system prompt, looks up the provider's registered function from ~*probabilistic-backends*~, calls it with the given model, and returns the result. This is the thin routing layer that sits between the reason pipeline and the provider-specific implementations in the unified-llm-backend skill.
|
|
|
|
* Implementation
|
|
|
|
** Request Execution (execute-llm-request)
|
|
#+begin_src lisp
|
|
(defun execute-llm-request (&key prompt system-prompt (provider :ollama) model)
|
|
"Central dispatcher for LLM requests."
|
|
(let ((backend (gethash provider *probabilistic-backends*)))
|
|
(if backend
|
|
(handler-case
|
|
(funcall backend prompt system-prompt :model model)
|
|
(error (c)
|
|
(list :status :error :message (format nil "~a Failure: ~a" provider c))))
|
|
(list :status :error :message (format nil "Provider ~a not registered" provider)))))
|
|
#+end_src
|
|
|
|
** Skill Registration
|
|
#+begin_src lisp
|
|
(defskill :skill-llm-gateway
|
|
:priority 100
|
|
:trigger (lambda (ctx) (getf ctx :user-input))
|
|
:deterministic (lambda (action ctx) (declare (ignore ctx)) action))
|
|
#+end_src
|
|
|
|
* Test Suite
|
|
#+begin_src lisp :tangle ../tests/llm-gateway-tests.lisp
|
|
(eval-when (:compile-toplevel :load-toplevel :execute)
|
|
(ql:quickload :fiveam :silent t))
|
|
|
|
(defpackage :opencortex-llm-gateway-tests
|
|
(:use :cl :opencortex)
|
|
(:export #:llm-gateway-suite))
|
|
|
|
(in-package :opencortex-llm-gateway-tests)
|
|
|
|
(fiveam:def-suite llm-gateway-suite :description "Tests for the LLM Gateway skill")
|
|
(fiveam:in-suite llm-gateway-suite)
|
|
|
|
(fiveam:test test-llm-gateway-timeout
|
|
"Tier 2 Chaos: Verify that LLM Gateway handles connection failures gracefully."
|
|
(let ((old-host (uiop:getenv "OLLAMA_HOST")))
|
|
(unwind-protect
|
|
(progn
|
|
(setf (uiop:getenv "OLLAMA_HOST") "localhost:1")
|
|
(let ((fn (or (find-symbol "EXECUTE-LLM-REQUEST" :opencortex.skills.org-skill-llm-gateway)
|
|
(find-symbol "EXECUTE-LLM-REQUEST" :opencortex))))
|
|
(if fn
|
|
(let ((result (funcall fn :prompt "hello" :provider :ollama)))
|
|
(fiveam:is (eq (getf result :status) :error))
|
|
(fiveam:is (uiop:string-prefix-p "Ollama Failure" (getf result :message))))
|
|
(fiveam:fail "Could not find EXECUTE-LLM-REQUEST symbol"))))
|
|
(if old-host
|
|
(setf (uiop:getenv "OLLAMA_HOST") old-host)
|
|
(sb-posix:unsetenv "OLLAMA_HOST")))))
|
|
#+end_src
|