passepartout/src/act.lisp

(in-package :opencortex)

(defvar *default-actuator* :CLI)
(defvar *silent-actuators* '(:CLI :SYSTEM-MESSAGE :EMACS))

(defun initialize-actuators ()
  "Loads actuator routing defaults from environment variables and registers core harness actuators."
  (let ((def (string-trim '(#\Space #\" #\') (or (uiop:getenv "DEFAULT_ACTUATOR") "CLI")))
        (silent (or (uiop:getenv "SILENT_ACTUATORS") "CLI,SYSTEM-MESSAGE,EMACS")))
    (when def
      (let ((clean-def (string-trim '(#\Space #\" #\') def)))
        (setf *default-actuator* (intern (string-upcase clean-def) "KEYWORD"))))
    (when silent
      (setf *silent-actuators*
            (mapcar (lambda (s) 
                      (let ((clean-s (string-trim '(#\Space #\" #\') s)))
                        (intern (string-upcase clean-s) "KEYWORD")))
                    (uiop:split-string silent :separator '(#\,))))))
  
  ;; Register core harness actuators
  (register-actuator :system #'execute-system-action)
  (register-actuator :tool #'execute-tool-action))

(defun dispatch-action (action context)
  (let ((payload (proto-get action :payload)))
    (when (eq (proto-get payload :sensor) :heartbeat)
      (return-from dispatch-action nil)))
  "Routes an approved action to its registered physical actuator."
  (when (and action (listp action))
    (let* ((raw-target (or (ignore-errors (getf action :TARGET))
                           (ignore-errors (getf action :target))
                           *default-actuator*))
           (target (intern (string-upcase (string raw-target)) :keyword))
           (actuator-fn (gethash target *actuator-registry*)))
      (if actuator-fn 
          (funcall actuator-fn action context) 
          (harness-log "ACT ERROR: No actuator for ~s (from ~s)" target raw-target)))))

(defun execute-system-action (action context)
  "Processes internal harness commands. (ACTUATOR)"
  (declare (ignore context))
  (let* ((payload (ignore-errors (getf action :payload))) 
         (cmd (ignore-errors (getf payload :action))))
    (case cmd
      (:eval (let ((code (getf payload :code)))
               (eval (read-from-string code))))
      (:create-skill (let* ((filename (getf payload :filename)) (content (getf payload :content))
                            (skills-dir (merge-pathnames "skills/" (asdf:system-source-directory :opencortex))) 
                            (full-path (merge-pathnames filename skills-dir)))
                       (with-open-file (out full-path :direction :output :if-exists :supersede) (write-string content out))
                       (load-skill-from-org full-path)))
      (:message (harness-log "ACT [System]: ~a" (getf payload :text)))
      (t (harness-log "ACT ERROR [System]: Unknown command ~s" cmd)))))

(defun execute-tool-action (action context)
  "Executes a registered cognitive tool. (ACTUATOR)"
  (let* ((payload (getf action :payload))
         (tool-name (getf payload :tool))
         (tool-args (getf payload :args))
         (depth (getf context :depth 0))
         (tool (gethash (string-downcase (string tool-name)) *cognitive-tools*)))
    (if tool
        (handler-case
            (let* ((clean-args (if (and (listp tool-args) (listp (car tool-args))) (car tool-args) tool-args))
                   (result (funcall (cognitive-tool-body tool) clean-args)))
              (list :type :EVENT :depth (1+ depth) :reply-stream (getf context :reply-stream)
                    :payload (list :sensor :tool-output :result result :tool tool-name)))
          (error (c)
            (list :type :EVENT :depth (1+ depth) :reply-stream (getf context :reply-stream)
                  :payload (list :sensor :tool-error :tool tool-name :message (format nil "~a" c)))))
        (list :type :EVENT :depth (1+ depth) :reply-stream (getf context :reply-stream)
              :payload (list :sensor :tool-error :message "Tool not found")))))

(defun act-gate (signal)
  "Final Stage: Actuation and feedback generation."
  (let* ((approved (proto-get signal :approved-action))
         (type (proto-get signal :type))
         (feedback nil))
    
    ;; 1. Last-Mile Safety Check (The Bouncer & Deterministic Gates)
    (when approved
      (let* ((original-type (getf approved :type))
             (verified (deterministic-verify approved signal)))
        (if (and (listp verified) 
                 (member (getf verified :type) '(:LOG :EVENT :log :event))
                 (not (member original-type '(:LOG :EVENT :log :event))))
            (progn
              (harness-log "ACT BLOCKED: Action failed last-mile deterministic check.")
              (setf (getf signal :APPROVED-ACTION) nil)
              (setf approved nil)
              (setf feedback verified))
            (progn
              (setf (getf signal :APPROVED-ACTION) verified)
              (setf approved verified)))))

    ;; 2. Actuation Logic
    (case type
      (:REQUEST (dispatch-action signal signal))
      (:LOG (dispatch-action signal signal))
      (:EVENT 
       (if approved
           (let* ((target (proto-get approved :target))
                  (result (dispatch-action approved signal)))
             ;; If the actuator returns a signal (like :tool-output), it becomes the feedback.
             ;; Otherwise, generate tool-output feedback for non-silent actuators.
             (cond ((and (listp result) (member (getf result :type) '(:EVENT :LOG)))
                    (setf feedback result))
                   ((and result (not (member target *silent-actuators*)))
                    (setf feedback (list :type :EVENT :depth (1+ (or (proto-get signal :depth) 0)) 
                                         :reply-stream (proto-get signal :reply-stream)
                                         :payload (list :sensor :tool-output :result result :tool approved))))))
           ;; If no approved action but we have a reply-stream, this might be a raw event/log stimulus.
           (when (proto-get signal :reply-stream)
             (dispatch-action signal signal)))))
    
    (setf (getf signal :status) :acted)
    feedback))