passepartout/skills/org-skill-config-manager.org

Skill: Config Manager (org-skill-config-manager.org)

• Overview
• Phase A: Demand (Thinking)
  • The Configuration Invariant
  • Hybrid Security Standard
• Phase B: Protocol (Success Criteria)
  • Test Suite Context
  • Registry Tests
• Phase C: Implementation (Build)
  • Package Context
  • Skill Metadata
  • Provider Templates
  • Registry Persistence
  • Registry API
  • Setup Wizard Implementation

Overview

The Config Manager skill provides the OpenCortex Agent with the capability to manage its own internal settings and LLM provider registry.

Phase A: Demand (Thinking)

The Configuration Invariant

A sovereign system must be able to re-configure its own connections. By moving the Setup Wizard and Provider Registry to a skill, we enable the Agent to "self-configure" or assist the user in adding new backends like Ollama or Groq without needing to reboot the kernel.

Hybrid Security Standard

Secrets are appended to `~/.config/opencortex/.env`, while structural metadata is stored in `~/.config/opencortex/providers.lisp`.

Phase B: Protocol (Success Criteria)

Test Suite Context

(defpackage :opencortex-config-manager-tests
  (:use :cl :fiveam :opencortex)
  (:export #:config-suite))

(in-package :opencortex-config-manager-tests)

(def-suite config-suite :description "Verification of the Config Manager skill")

(in-suite config-suite)

Registry Tests

(test test-provider-registration
  "Verify that multiple providers can be registered and saved."
  (let ((opencortex::*providers* nil))
    (opencortex:register-provider :ollama '(:url "http://localhost:11434"))
    (is (equal "http://localhost:11434" (getf (getf opencortex::*providers* :ollama) :url)))))

Phase C: Implementation (Build)

Package Context

(in-package :opencortex)

Skill Metadata

(defparameter *skill-config-manager*
  '(:name "config-manager"
    :description "Manages system settings and LLM provider configurations."
    :capabilities (:configure-provider :run-setup-wizard)
    :type :deterministic)
  "Skill metadata for the Config Manager.")

Provider Templates

(defvar *provider-templates*
  '((:ollama . (:name "Ollama (Local)" :fields ((:url :label "URL") (:model :label "Model")) :default-url "http://localhost:11434" :default-model "llama3"))
    (:openrouter . (:name "OpenRouter" :fields ((:key :label "API Key" :secret t) (:model :label "Model")) :default-model "anthropic/claude-3-opus-20240229"))
    (:openai . (:name "OpenAI" :fields ((:key :label "API Key" :secret t) (:model :label "Model")) :default-model "gpt-4-turbo"))
    (:groq . (:name "Groq" :fields ((:key :label "API Key" :secret t) (:model :label "Model")) :default-model "mixtral-8x7b-32768"))
    (:gemini . (:name "Google Gemini" :fields ((:key :label "API Key" :secret t) (:model :label "Model")) :default-model "gemini-1.5-pro"))
    (:anthropic . (:name "Anthropic" :fields ((:key :label "API Key" :secret t) (:model :label "Model")) :default-model "claude-3-5-sonnet-20240620")))
  "Templates for supported LLM providers.")

Registry Persistence

(defvar *providers* nil "Global registry of configured LLM providers.")

(defun save-providers ()
  "Persist provider configuration to XDG config directory."
  (let ((path (merge-pathnames "providers.lisp" (get-oc-config-dir))))
    (ensure-directories-exist path)
    (with-open-file (s path :direction :output :if-exists :supersede)
      (format s ";;; OpenCortex Provider Metadata~%~s~%" *providers*))))

Registry API

(defun register-provider (id config)
  "Update the global provider registry."
  (setf (getf *providers* id) config))

Setup Wizard Implementation

(defun configure-provider (id)
  "Guided configuration for a specific LLM provider template."
  (let* ((template (cdr (assoc id *provider-templates*)))
         (fields (getf template :fields))
         (config nil))
    (format t "~%--- Configuring ~a ---~%" (getf template :name))
    (dolist (field-spec fields)
      (let* ((field (first field-spec))
             (label (getf (rest field-spec) :label))
             (is-secret (getf (rest field-spec) :secret))
             (default-key (intern (format nil "DEFAULT-~a" field) :keyword))
             (default (getf template default-key))
             (val (prompt-for label default)))
        (if is-secret
            (save-secret id field val)
            (setf (getf config field) val))))
    (register-provider id config)
    (format t "✓ ~a metadata registered.~%" (getf template :name))))

(defun run-setup-wizard ()
  "Entry point for the interactive OpenCortex Lisp Setup Wizard."
  (format t "=== OpenCortex: Advanced Setup Wizard ===~%")
  (let ((user (prompt-for "Your Name" "User"))
        (agent (prompt-for "Agent Name" "OpenCortex")))
    (format t "Welcome, ~a. I am ~a.~%" user agent))
  (format t "~%Available Providers:~%")
  (loop for (id . data) in *provider-templates* do (format t "  ~a: ~a~%" id (getf data :name)))
  (format t "~%Enter provider IDs to configure (comma separated, or 'all'): ")
  (finish-output)
  (let* ((input (read-line))
         (ids (if (string= input "all")
                  (mapcar #'car *provider-templates*)
                  (mapcar (lambda (s) (intern (string-upcase (string-trim " " s)) :keyword))
                          (uiop:split-string input :separator ",")))))
    (dolist (id ids)
      (when (assoc id *provider-templates*)
        (configure-provider id))))
  (save-providers)
  (format t "~%Setup complete. Running diagnostics...~%")
  (doctor-run-all))