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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: axel-protocol
-Version: 2.3.0
+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.0 → axel_protocol-2.3.2}/axel/cli.py

@@ -427,6 +427,27 @@ def _fire_task(server: str, fr: str, to: str, action: str, body: dict) -> None:
         pass  # demo continues even if event fire fails
 
 
+def _fire_progress(server: str, run: int, step: int, total: int, agent: str, action: str) -> None:
+    """Broadcast pipeline progress so the dashboard can show a step indicator."""
+    import json as _json
+    import urllib.request as _ur
+    import uuid as _uuid
+    msg = {
+        "t": "PROG", "v": "2.1",
+        "id": str(_uuid.uuid4()),
+        "fr": "axel-demo", "to": "dashboard",
+        "body": {"run": run, "step": step, "total": total,
+                 "agent": agent, "action": action},
+    }
+    data = _json.dumps(msg).encode()
+    req = _ur.Request(f"{server}/send", data=data,
+                      headers={"Content-Type": "application/json"}, method="POST")
+    try:
+        _ur.urlopen(req, timeout=3)
+    except Exception:
+        pass
+
+
 def _fire_result(server: str, fr: str, to: str, action: str, body: dict) -> None:
     """POST an AXEL OK result message through the server so SSE/dashboard sees it."""
     import json as _json
@@ -657,6 +678,24 @@ def cmd_demo(args):  # noqa: C901
         "Building trust and reliability in multi-agent systems",
     ]
 
+    def _check_user_queue(srv):
+        """Check if a user submitted a task via the dashboard. Returns task string or None."""
+        try:
+            resp = _ur.urlopen(f"{srv}/queue", timeout=3)
+            data = json.loads(resp.read())
+            return data.get("task")  # None if queue was empty
+        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
@@ -674,12 +713,16 @@ def cmd_demo(args):  # noqa: C901
         except Exception:
             return ""
 
+    step_counter = [0]   # mutable so inner func can update it
+
     def step(fr, to, action, prompt, learn_key=None, learn_insight=None, mem_ctx=""):
         """Fire a task, call the LLM (or use mock), fire the result."""
+        step_counter[0] += 1
         full_prompt = (mem_ctx + prompt) if mem_ctx else prompt
         mdl = _agent_model(to)
         mdl_short = mdl.split("/")[-1].replace(":free", "") if mdl != "auto/free" else "free"
         print(f"\n  {fr} → {to}  [{action}]  ({mdl_short})")
+        _fire_progress(server, run_count, step_counter[0], 5, to, action)
         _fire_task(server, fr, to, action, {"prompt": prompt[:200]})
         if mock:
             time.sleep(0.8)
@@ -713,7 +756,20 @@ def cmd_demo(args):  # noqa: C901
     try:
         while True:
             run_count += 1
-            topic = _TOPICS[(run_count - 1) % len(_TOPICS)]
+            step_counter[0] = 0   # reset step counter for new run
+            # 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:
+                # 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.0 → axel_protocol-2.3.2}/axel/server.py

@@ -375,6 +375,12 @@ class AXELServer:
         # Liveness: agent_id → last-seen timestamp (unix seconds)
         self._last_seen: Dict[str, float] = {}
         self._liveness_lock = threading.Lock()
+        # 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()
@@ -927,6 +933,57 @@ class AXELServer:
                 result["db_stats"] = self.persistence.stats()
             return result
 
+        # ── User Task Queue ───────────────────────────────────────
+        @app.post("/queue")
+        async def queue_task(request: Request):
+            """Dashboard submits a user task here; the demo loop picks it up."""
+            body = await request.json()
+            task = (body.get("task") or "").strip()
+            if not task:
+                return {"ok": False, "error": "task is required"}
+            with self._task_queue_lock:
+                self._task_queue.append(task)
+            # Broadcast so the dashboard knows the task was received
+            self.event_bus.publish("user.task", {"task": task, "queued": len(self._task_queue)})
+            return {"ok": True, "queued": len(self._task_queue)}
+
+        @app.get("/queue")
+        async def peek_queue():
+            """Pop and return the next user task, or null if queue is empty."""
+            with self._task_queue_lock:
+                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.0 → axel_protocol-2.3.2}/axel/static/monitor.html

@@ -63,6 +63,30 @@ header {
 .stat-val { font-size: 20px; font-weight: 700; color: var(--accent); line-height: 1; }
 .stat-lbl { font-size: 9px; text-transform: uppercase; letter-spacing: .8px; color: var(--muted); margin-top: 2px; }
 
+/* ── Mission input bar ── */
+.mission-bar {
+  display: flex; align-items: center; gap: 10px;
+  padding: 8px 18px; background: rgba(129,140,248,.04);
+  border-bottom: 1px solid var(--border); flex-shrink: 0;
+}
+.mission-input {
+  flex: 1; background: var(--bg); border: 1px solid var(--border); color: var(--text);
+  padding: 7px 12px; border-radius: 7px; font-size: 12px;
+  transition: border-color .2s;
+}
+.mission-input:focus { outline: none; border-color: var(--accent); }
+.mission-input::placeholder { color: var(--muted); }
+.mission-btn {
+  background: var(--accent); color: #fff; border: none;
+  padding: 7px 16px; border-radius: 7px; font-size: 12px; font-weight: 600; cursor: pointer;
+  white-space: nowrap; transition: opacity .2s;
+}
+.mission-btn:hover { opacity: .85; }
+.mission-btn:disabled { opacity: .4; cursor: default; }
+.mission-status { font-size: 11px; color: var(--muted); white-space: nowrap; min-width: 120px; }
+.mission-status.sent { color: var(--green); }
+.mission-status.waiting { color: var(--yellow); }
+
 /* ── Progress strip ── */
 .progress-strip {
   display: none; align-items: center; gap: 14px;
@@ -199,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;
@@ -289,6 +344,27 @@ header {
   <div class="stat"><div class="stat-val" id="sUptime">–</div><div class="stat-lbl">Uptime</div></div>
 </div>
 
+<div class="mission-bar">
+  <span style="font-size:13px">🎯</span>
+  <input class="mission-input" id="missionInput" placeholder="Give the agents a task… e.g. 'Research the impact of AI on creative industries'" />
+  <button class="mission-btn" id="missionBtn" onclick="submitMission()">Send to Agents →</button>
+  <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">
@@ -422,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')) {
@@ -533,10 +609,20 @@ function onEvent(d) {
     pulseAgent(from, 'learning');
     setTimeout(poll, 600);
 
+  } else if (type === 'user.task') {
+    const task = p.task || p.data?.task || '';
+    addFeed('announce', '🎯', `<b>User</b> sent a mission: <i>${esc(task.slice(0,80))}${task.length>80?'…':''}</i>`, 'Agents will pick this up on the next run', { rawType:'USER', fullPrompt: task });
+    const status = document.getElementById('missionStatus');
+    if (status) { status.textContent = '⏳ waiting for agents…'; status.className = 'mission-status waiting'; }
+
   } else if (p.t === 'PROG' || type.includes('progress')) {
     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 });
@@ -901,6 +987,110 @@ function toggleMem() {
   document.getElementById('memHint').textContent = memExpanded ? '▴ collapse' : '▾ expand';
 }
 
+// ─── Mission input ─────────────────────────────────────────
+function submitMission() {
+  const input  = document.getElementById('missionInput');
+  const btn    = document.getElementById('missionBtn');
+  const status = document.getElementById('missionStatus');
+  const task   = input.value.trim();
+  if (!task) { input.focus(); return; }
+
+  btn.disabled = true;
+  status.textContent = 'sending…';
+  status.className = 'mission-status';
+
+  fetch(serverUrl + '/queue', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ task }),
+  })
+  .then(r => r.json())
+  .then(d => {
+    if (d.ok) {
+      status.textContent = '✓ queued — agents will pick it up next run';
+      status.className = 'mission-status sent';
+      input.value = '';
+      setTimeout(() => {
+        status.textContent = 'agents running autonomously';
+        status.className = 'mission-status';
+        btn.disabled = false;
+      }, 4000);
+    } else {
+      status.textContent = 'error: ' + (d.error || 'unknown');
+      btn.disabled = false;
+    }
+  })
+  .catch(() => {
+    status.textContent = 'could not reach server';
+    status.className = 'mission-status';
+    btn.disabled = false;
+  });
+}
+
+// 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.0 → axel_protocol-2.3.2}/pyproject.toml

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