Initial commit: extracted from memex

docs/PROTOCOL_model_discovery.org

@@ -0,0 +1,51 @@
+#+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