SKILL: Org-Native Delivery Agent (Universal Literate Note)

Overview
Phase A: Demand (PRD)
Phase B: Blueprint (PROTOCOL)
- 1. Architectural Intent
- 2. Semantic Interfaces
Phase D: Build (Implementation)
- Queue Actuation
Registration

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)

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)

1. Architectural Intent

Interfaces for external communication. Source of truth is the `delivery.org` queue and system credentials.

2. Semantic Interfaces

(defun execute-org-delivery (action)
  "Enqueues a message in delivery.org.")

(defun format-universal-time-org (ut)
  "Formats time for Org-mode properties.")

Phase D: Build (Implementation)

Queue Actuation

(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)))

Registration

(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))

2.0 KiB Raw Blame History