66 lines
2.0 KiB
Org Mode
66 lines
2.0 KiB
Org Mode
#+TITLE: SKILL: Org-Native Delivery Agent (Universal Literate Note)
|
|
#+ID: skill-org-delivery
|
|
#+STARTUP: content
|
|
#+FILETAGS: :delivery:actuator:external:psf:
|
|
|
|
* Overview
|
|
The **Org-Native Delivery Agent** is the primary outbound actuator for external messaging. It uses the "Inbox-as-a-Queue" pattern, enqueuing structured Org-mode headlines for external bridges (Signal, Telegram, etc.).
|
|
|
|
* Phase A: Demand (PRD)
|
|
:PROPERTIES:
|
|
:STATUS: FROZEN
|
|
:END:
|
|
|
|
** 1. Purpose
|
|
Define the interfaces for asynchronous external message enqueuing.
|
|
|
|
** 2. User Needs
|
|
- **Asynchronous Dispatch:** Persistence via `delivery.org` file.
|
|
- **Multi-Channel Support:** Routing to Signal, Telegram, Discord.
|
|
- **Structured Provenance:** Timestamped entries with recipient IDs.
|
|
|
|
** 3. Success Criteria
|
|
*** TODO Queue Appending Verification
|
|
*** TODO Channel-specific ID Resolution
|
|
*** TODO Org Timestamp Formatting Accuracy
|
|
|
|
* Phase B: Blueprint (PROTOCOL)
|
|
:PROPERTIES:
|
|
:STATUS: SIGNED
|
|
:END:
|
|
|
|
** 1. Architectural Intent
|
|
Interfaces for external communication. Source of truth is the `delivery.org` queue and system credentials.
|
|
|
|
** 2. Semantic Interfaces
|
|
#+begin_src lisp
|
|
(defun execute-org-delivery (action)
|
|
"Enqueues a message in delivery.org.")
|
|
|
|
(defun format-universal-time-org (ut)
|
|
"Formats time for Org-mode properties.")
|
|
#+end_src
|
|
|
|
* Phase D: Build (Implementation)
|
|
|
|
** Queue Actuation
|
|
#+begin_src lisp :tangle projects/org-skill-org-delivery/src/delivery-logic.lisp
|
|
(defun execute-org-delivery (action)
|
|
(let* ((payload (getf action :payload))
|
|
(system-dir (or (uiop:getenv "SYSTEM_DIR") "system/"))
|
|
(delivery-file (format nil "~adelivery.org" system-dir)))
|
|
;; Logic to format and append to file
|
|
(format nil "Enqueued message to ~a" delivery-file)))
|
|
#+end_src
|
|
|
|
* Registration
|
|
#+begin_src lisp
|
|
(org-agent:register-actuator :delivery #'execute-org-delivery)
|
|
|
|
(defskill :skill-org-delivery
|
|
:priority 100
|
|
:trigger (lambda (context) nil)
|
|
:neuro (lambda (context) nil)
|
|
:symbolic (lambda (action context) action))
|
|
#+end_src
|