axel-protocol 2.3.1__tar.gz → 2.3.2__tar.gz

{axel_protocol-2.3.1 → axel_protocol-2.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: axel-protocol
-Version: 2.3.1
+Version: 2.3.2
 Summary: AXEL — Agent eXchange Language: a universal protocol for multi-LLM networks
 Project-URL: Homepage, https://github.com/sectorx/axel-protocol
 Project-URL: Repository, https://github.com/sectorx/axel-protocol

{axel_protocol-2.3.1 → axel_protocol-2.3.2}/axel/cli.py

@@ -687,6 +687,15 @@ def cmd_demo(args):  # noqa: C901
         except Exception:
             return None
 
+    def _fetch_topic_library(srv):
+        """Fetch user-defined learning topics from the server. Returns list or []."""
+        try:
+            resp = _ur.urlopen(f"{srv}/topics", timeout=3)
+            data = json.loads(resp.read())
+            return data.get("topics", [])
+        except Exception:
+            return []
+
     def _fetch_memory_context(srv):
         """Pull top lessons from shared memory and format as context."""
         import json
@@ -748,13 +757,19 @@ def cmd_demo(args):  # noqa: C901
         while True:
             run_count += 1
             step_counter[0] = 0   # reset step counter for new run
-            # Check if user submitted a task from the dashboard
+            # Check if user submitted a one-off task from the dashboard
             user_task = _check_user_queue(server)
             if user_task:
                 topic = user_task
                 print(f"\n  ⌨️   User task received: \"{topic}\"")
             else:
-                topic = _TOPICS[(run_count - 1) % len(_TOPICS)]
+                # Pull user-defined topic library — use it if populated
+                user_topics = _fetch_topic_library(server)
+                if user_topics:
+                    topic = user_topics[(run_count - 1) % len(user_topics)]
+                    print(f"\n  📚  Topic Library ({len(user_topics)} topics) — exploring: \"{topic}\"")
+                else:
+                    topic = _TOPICS[(run_count - 1) % len(_TOPICS)]
 
             # Fetch lessons learned so far — injected into prompts so agents remember
             mem_ctx = _fetch_memory_context(server) if run_count > 1 else ""

{axel_protocol-2.3.1 → axel_protocol-2.3.2}/axel/server.py

@@ -378,6 +378,9 @@ class AXELServer:
         # User task queue — dashboard POSTs tasks here; demo loop pops them
         self._task_queue: list = []
         self._task_queue_lock = threading.Lock()
+        # User-defined topic library — agents explore these instead of built-in topics
+        self._topic_library: list = []
+        self._topic_lock = threading.Lock()
         # Restore persisted agents/memory if db is attached
         if self.persistence:
             self._restore_from_db()
@@ -951,6 +954,36 @@ class AXELServer:
                 task = self._task_queue.pop(0) if self._task_queue else None
             return {"task": task, "remaining": len(self._task_queue)}
 
+        # ── Topic Library ─────────────────────────────────────────
+        @app.post("/topics")
+        async def add_topic(request: Request):
+            """Add a topic to the learning library."""
+            body = await request.json()
+            topic = (body.get("topic") or "").strip()
+            if not topic:
+                return {"ok": False, "error": "topic is required"}
+            with self._topic_lock:
+                if topic not in self._topic_library:
+                    self._topic_library.append(topic)
+            self.event_bus.publish("topics.updated", {"topics": list(self._topic_library)})
+            return {"ok": True, "topics": list(self._topic_library)}
+
+        @app.get("/topics")
+        async def list_topics():
+            """Return all user-defined topics."""
+            with self._topic_lock:
+                return {"topics": list(self._topic_library)}
+
+        @app.delete("/topics/{idx}")
+        async def remove_topic(idx: int):
+            """Remove a topic by index."""
+            with self._topic_lock:
+                if idx < 0 or idx >= len(self._topic_library):
+                    return {"ok": False, "error": "index out of range"}
+                removed = self._topic_library.pop(idx)
+            self.event_bus.publish("topics.updated", {"topics": list(self._topic_library)})
+            return {"ok": True, "removed": removed, "topics": list(self._topic_library)}
+
         # ── SSE Event Stream ─────────────────────────────────────
         @app.get("/stream")
         async def event_stream(request: Request):

{axel_protocol-2.3.1 → axel_protocol-2.3.2}/axel/static/monitor.html

@@ -223,6 +223,37 @@ header {
 .conf-bar { height: 2px; background: var(--border); border-radius: 2px; margin-top: 5px; }
 .conf-fill { height: 100%; background: var(--green); border-radius: 2px; transition: width .5s; }
 
+/* ── Topic Library bar ── */
+.topic-bar {
+  display: flex; align-items: flex-start; gap: 10px;
+  padding: 8px 18px; background: rgba(251,191,36,.03);
+  border-bottom: 1px solid var(--border); flex-shrink: 0;
+}
+.topic-bar-label { font-size: 10px; text-transform: uppercase; letter-spacing: .7px; color: var(--yellow); font-weight: 700; }
+.topic-bar-body { flex: 1; min-width: 0; display: flex; flex-direction: column; gap: 5px; }
+.topic-bar-row { display: flex; align-items: center; gap: 8px; }
+.topic-input {
+  flex: 1; background: var(--bg); border: 1px solid var(--border); color: var(--text);
+  padding: 5px 10px; border-radius: 6px; font-size: 12px; min-width: 0;
+}
+.topic-input:focus { outline: none; border-color: var(--yellow); }
+.topic-add-btn {
+  padding: 5px 12px; border-radius: 6px; border: 1px solid rgba(251,191,36,.4);
+  background: rgba(251,191,36,.08); color: var(--yellow); font-size: 12px; cursor: pointer;
+  white-space: nowrap; transition: background .15s;
+}
+.topic-add-btn:hover { background: rgba(251,191,36,.18); }
+.topic-chips { display: flex; flex-wrap: wrap; gap: 5px; }
+.topic-chip {
+  display: inline-flex; align-items: center; gap: 5px;
+  background: rgba(251,191,36,.1); border: 1px solid rgba(251,191,36,.25);
+  border-radius: 20px; padding: 3px 8px 3px 10px; font-size: 11px; color: var(--text);
+}
+.topic-chip-text { white-space: nowrap; overflow: hidden; text-overflow: ellipsis; max-width: 200px; }
+.topic-chip-x { cursor: pointer; color: var(--muted); font-size: 14px; line-height: 1; flex-shrink: 0; transition: color .15s; }
+.topic-chip-x:hover { color: var(--red); }
+.topic-empty { font-size: 11px; color: var(--muted); }
+
 /* ── Settings overlay ── */
 .settings-overlay {
   position: fixed; inset: 0; z-index: 200;
@@ -320,6 +351,20 @@ header {
   <span class="mission-status" id="missionStatus">agents running autonomously</span>
 </div>
 
+<div class="topic-bar">
+  <span style="font-size:15px;line-height:1;padding-top:1px">📚</span>
+  <div class="topic-bar-body">
+    <div class="topic-bar-label">Learning Topics <span style="font-weight:400;text-transform:none;letter-spacing:0;color:var(--muted)">— agents will cycle through these instead of built-in topics</span></div>
+    <div class="topic-bar-row">
+      <input class="topic-input" id="topicInput" placeholder="Add a topic… e.g. 'The ethics of autonomous AI systems'" />
+      <button class="topic-add-btn" onclick="addTopic()">+ Add Topic</button>
+    </div>
+    <div class="topic-chips" id="topicChips">
+      <span class="topic-empty">No topics yet — agents use built-in rotation</span>
+    </div>
+  </div>
+</div>
+
 <div class="progress-strip" id="progressStrip">
   <div class="prog-label" id="progLabel">Run #1</div>
   <div class="prog-dots">
@@ -453,7 +498,7 @@ function reconnect() {
 function connect() {
   setConn(false);
   sse = new EventSource(serverUrl + '/stream');
-  sse.onopen  = () => { setConn(true); poll(); };
+  sse.onopen  = () => { setConn(true); poll(); loadTopics(); };
   sse.onerror = () => {
     setConn(false);
     if (document.getElementById('toggleAR').classList.contains('on')) {
@@ -574,6 +619,10 @@ function onEvent(d) {
     const b = p.body || p;
     updateProgress(b.run ?? 1, b.step ?? 1, b.total ?? 5, b.agent || '', b.action || '');
 
+  } else if (type === 'topics.updated') {
+    topicLibrary = p.topics || [];
+    renderTopics();
+
   } else if (type.includes('error')) {
     const msg = p.body?.error || p.error || '';
     addFeed('error', '❌', `Error from <b>${p.fr||'?'}</b>`, msg, { rawType:'ERR', from:p.fr, fullText:msg });
@@ -981,8 +1030,67 @@ function submitMission() {
 // Allow Enter key to submit
 document.addEventListener('keydown', e => {
   if (e.key === 'Enter' && document.activeElement.id === 'missionInput') submitMission();
+  if (e.key === 'Enter' && document.activeElement.id === 'topicInput') addTopic();
 });
 
+// ─── Topic Library ─────────────────────────────────────────────
+let topicLibrary = [];
+
+function renderTopics() {
+  const chips = document.getElementById('topicChips');
+  if (!chips) return;
+  if (topicLibrary.length === 0) {
+    chips.innerHTML = '<span class="topic-empty">No topics yet — agents use built-in rotation</span>';
+    return;
+  }
+  chips.innerHTML = topicLibrary.map((t, i) =>
+    `<span class="topic-chip">
+      <span class="topic-chip-text" title="${esc(t)}">${esc(t)}</span>
+      <span class="topic-chip-x" onclick="removeTopic(${i})" title="Remove">×</span>
+    </span>`
+  ).join('');
+}
+
+function addTopic() {
+  const input = document.getElementById('topicInput');
+  const topic = (input.value || '').trim();
+  if (!topic) { input.focus(); return; }
+  fetch(serverUrl + '/topics', {
+    method: 'POST',
+    headers: {'Content-Type':'application/json'},
+    body: JSON.stringify({topic})
+  })
+  .then(r => r.json())
+  .then(d => {
+    if (d.ok) {
+      topicLibrary = d.topics;
+      input.value = '';
+      renderTopics();
+      addFeed('announce', '📚', `<b>Topic added:</b> ${esc(topic.slice(0,80))}`, 'Agents will explore this on the next run', {rawType:'TOPIC'});
+    }
+  })
+  .catch(() => {});
+}
+
+function removeTopic(idx) {
+  fetch(serverUrl + `/topics/${idx}`, { method: 'DELETE' })
+  .then(r => r.json())
+  .then(d => {
+    if (d.ok !== false) {
+      topicLibrary = d.topics;
+      renderTopics();
+    }
+  })
+  .catch(() => {});
+}
+
+function loadTopics() {
+  fetch(serverUrl + '/topics')
+  .then(r => r.json())
+  .then(d => { topicLibrary = d.topics || []; renderTopics(); })
+  .catch(() => {});
+}
+
 // ─── Settings ──────────────────────────────────────────────────
 function openSettings() {
   document.getElementById('settingsUrl').value = serverUrl;

{axel_protocol-2.3.1 → axel_protocol-2.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "axel-protocol"
-version = "2.3.1"
+version = "2.3.2"
 description = "AXEL — Agent eXchange Language: a universal protocol for multi-LLM networks"
 readme = "README.md"
 license = { file = "LICENSE" }