51 lines
1.7 KiB
Org Mode
51 lines
1.7 KiB
Org Mode
#+TITLE: PROTOCOL: Model Discovery
|
|
#+AUTHOR: PSF Architect
|
|
#+DATE: 2026-03-24
|
|
#+STARTUP: content
|
|
|
|
* Overview
|
|
This protocol defines the interfaces allowing the `org-agent` to dynamically introspect available models from any loaded provider skill, outputting the result to Emacs as an Org table.
|
|
|
|
* 1. The Provider Export Interface
|
|
Every skill acting as a Neural Provider MUST export a function named `GET-AVAILABLE-MODELS`.
|
|
|
|
#+begin_src lisp
|
|
;; Signature
|
|
(get-available-models) -> list-of-plists
|
|
|
|
;; Return Format Example
|
|
'((:id "gpt-4-turbo" :context "128k")
|
|
(:id "gpt-4o" :context "128k"))
|
|
#+end_src
|
|
|
|
* 2. The Model Explorer Skill (`skill-model-explorer.org`)
|
|
|
|
** Dynamic Introspection
|
|
The explorer uses the kernel's `(org-agent:context-list-all-skills)` API to find all skills whose name starts with `skill-provider-`.
|
|
|
|
For each matching skill, it looks up the package:
|
|
#+begin_src lisp
|
|
(let* ((pkg (find-package (intern (string-upcase (format nil "ORG-AGENT.SKILLS.~a" skill-name)) :keyword)))
|
|
(fn (when pkg (find-symbol "GET-AVAILABLE-MODELS" pkg))))
|
|
(when (and fn (fboundp fn))
|
|
(funcall fn)))
|
|
#+end_src
|
|
|
|
** Org-Table Formatting
|
|
The explorer aggregates the plists and formats them into an Org table string:
|
|
#+begin_example
|
|
| Provider | Model ID | Context |
|
|
|----------+----------+---------|
|
|
| OpenAI | gpt-4o | 128k |
|
|
#+end_example
|
|
|
|
* 3. Emacs Actuator Command
|
|
The explorer generates a System 2 `approved-action` that instructs the `:emacs` actuator to insert this text.
|
|
|
|
#+begin_src lisp
|
|
'(:type :REQUEST
|
|
:target :emacs
|
|
:payload (:action :insert-text
|
|
:text "| Provider | Model ID | Context |\n..."
|
|
:position :after-trigger))
|
|
#+end_src |