agentify-toolkit 0.4.3a1__py3-none-any.whl

agentify/specs.py

@@ -0,0 +1,19 @@
+# Copyright 2026 Backplane Software
+# Licensed under the Apache License, Version 2.0
+
+from pathlib import Path
+import yaml
+   
+def load_agent_specs(agent_dir: Path | str = "agents") -> list[dict]:
+    agent_dir = Path(agent_dir)
+    specs = []
+    for path in agent_dir.glob("*.yaml"):
+        with open(path, "r") as f:
+            spec = yaml.safe_load(f)
+            spec["_file"] = path.name  # optional metadata
+            specs.append(spec)
+    return specs
+
+
+
+

agentify/ui/basic-chat.css

@@ -0,0 +1,230 @@
+body {
+  font-family: "Segoe UI", Tahoma, Geneva, Verdana, sans-serif;
+  background: #f1f5f9;
+  margin: 0;
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  height: 100vh;
+  padding: 2rem;
+  box-sizing: border-box;
+  overflow: hidden;
+}
+
+#chat-container {
+  width: 100%;
+  max-width: 600px;
+  background: #ffffff;
+  border-radius: 24px;
+  box-shadow: 0 8px 32px rgba(0, 0, 0, 0.08);
+  display: flex;
+  flex-direction: column;
+  padding: 2rem;
+  height: 600px;
+  border: 1px solid rgba(226, 232, 240, 0.8);
+}
+
+#chat-header {
+  font-family: "Poppins", sans-serif;
+  font-size: 1.75rem;
+  font-weight: 700;
+  margin-bottom: 0.25rem;
+  color: #1e293b;
+}
+
+.tagline {
+  font-family: "Poppins", sans-serif;
+  font-size: 0.875rem;
+  color: #64748b;
+  margin-bottom: 1.5rem;
+  font-weight: 400;
+}
+
+#chat {
+  flex-grow: 1;
+  overflow-y: auto;
+  margin-bottom: 1.5rem;
+  padding-right: 0.5rem;
+  display: flex;
+  flex-direction: column;
+}
+
+/* Custom scrollbar */
+#chat::-webkit-scrollbar {
+  width: 6px;
+}
+
+#chat::-webkit-scrollbar-track {
+  background: #f1f5f9;
+  border-radius: 10px;
+}
+
+#chat::-webkit-scrollbar-thumb {
+  background: #cbd5e1;
+  border-radius: 10px;
+  transition: background 0.2s;
+}
+
+#chat::-webkit-scrollbar-thumb:hover {
+  background: #94a3b8;
+}
+
+.message {
+  padding: 0.875rem 1.125rem;
+  margin-bottom: 0.75rem;
+  border-radius: 18px;
+  position: relative;
+  max-width: 75%;
+  word-wrap: break-word;
+  line-height: 1.5;
+  animation: fadeIn 0.3s ease-in;
+}
+
+@keyframes fadeIn {
+  from {
+    opacity: 0;
+    transform: translateY(10px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+.message.user {
+  background: #1e293b;
+  color: #ffffff;
+  align-self: flex-end;
+  border-bottom-right-radius: 6px;
+  box-shadow: 0 2px 8px rgba(30, 41, 59, 0.15);
+  margin-left: auto;
+}
+
+.message.agent {
+  background: #f8fafc;
+  color: #1e293b;
+  align-self: flex-start;
+  border-bottom-left-radius: 6px;
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.06);
+  border: 1px solid #e2e8f0;
+}
+
+.message.agent.typing {
+  font-style: italic;
+  color: #64748b;
+  background: #f8fafc;
+  border: 1px solid #e2e8f0;
+}
+
+.timestamp {
+  font-size: 0.7rem;
+  color: rgba(255, 255, 255, 0.7);
+  margin-top: 4px;
+  display: block;
+}
+
+.message.agent .timestamp {
+  color: #94a3b8;
+}
+
+form {
+  display: flex;
+  gap: 0.75rem;
+  align-items: center;
+}
+
+#question-input {
+  flex-grow: 1;
+  padding: 0.875rem 1.25rem;
+  font-size: 0.95rem;
+  border-radius: 16px;
+  border: 1.5px solid #e2e8f0;
+  outline: none;
+  background-color: #ffffff;
+  transition: all 0.2s ease-in-out;
+  font-family: inherit;
+}
+
+#question-input:focus {
+  border-color: #1e293b;
+  box-shadow: 0 0 0 3px rgba(30, 41, 59, 0.08);
+  background-color: #ffffff;
+}
+
+#question-input::placeholder {
+  color: #94a3b8;
+}
+
+button {
+  background: #1e293b;
+  color: white;
+  border: none;
+  border-radius: 16px;
+  padding: 0.875rem 1.5rem;
+  font-size: 0.95rem;
+  font-weight: 600;
+  cursor: pointer;
+  transition: all 0.2s ease-in-out;
+  box-shadow: 0 2px 8px rgba(30, 41, 59, 0.15);
+  white-space: nowrap;
+}
+
+button:hover {
+  background: #0f172a;
+  transform: translateY(-1px);
+  box-shadow: 0 4px 12px rgba(30, 41, 59, 0.2);
+}
+
+button:active {
+  transform: translateY(0);
+  box-shadow: 0 1px 4px rgba(30, 41, 59, 0.15);
+}
+
+button:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+  transform: none;
+}
+
+button:focus {
+  outline: 2px solid #64748b;
+  outline-offset: 2px;
+}
+
+/* Optional: Add a subtle pattern to the body */
+body::before {
+  content: "";
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  background-image: radial-gradient(
+      circle at 20% 30%,
+      rgba(148, 163, 184, 0.03) 0%,
+      transparent 50%
+    ),
+    radial-gradient(
+      circle at 80% 70%,
+      rgba(148, 163, 184, 0.03) 0%,
+      transparent 50%
+    );
+  pointer-events: none;
+  z-index: -1;
+}
+
+/* Responsive adjustments */
+@media (max-width: 640px) {
+  body {
+    padding: 1rem;
+  }
+
+  #chat-container {
+    padding: 1.5rem;
+    height: calc(100vh - 2rem);
+  }
+
+  .message {
+    max-width: 85%;
+  }
+}

agentify/ui/chat.css

@@ -0,0 +1,230 @@
+body {
+  font-family: "Segoe UI", Tahoma, Geneva, Verdana, sans-serif;
+  background: #f1f5f9;
+  margin: 0;
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  height: 100vh;
+  padding: 2rem;
+  box-sizing: border-box;
+  overflow: hidden;
+}
+
+#chat-container {
+  width: 100%;
+  max-width: 600px;
+  background: #ffffff;
+  border-radius: 24px;
+  box-shadow: 0 8px 32px rgba(0, 0, 0, 0.08);
+  display: flex;
+  flex-direction: column;
+  padding: 2rem;
+  height: 600px;
+  border: 1px solid rgba(226, 232, 240, 0.8);
+}
+
+#chat-header {
+  font-family: "Poppins", sans-serif;
+  font-size: 1.75rem;
+  font-weight: 700;
+  margin-bottom: 0.25rem;
+  color: #1e293b;
+}
+
+.tagline {
+  font-family: "Poppins", sans-serif;
+  font-size: 0.875rem;
+  color: #64748b;
+  margin-bottom: 1.5rem;
+  font-weight: 400;
+}
+
+#chat {
+  flex-grow: 1;
+  overflow-y: auto;
+  margin-bottom: 1.5rem;
+  padding-right: 0.5rem;
+  display: flex;
+  flex-direction: column;
+}
+
+/* Custom scrollbar */
+#chat::-webkit-scrollbar {
+  width: 6px;
+}
+
+#chat::-webkit-scrollbar-track {
+  background: #f1f5f9;
+  border-radius: 10px;
+}
+
+#chat::-webkit-scrollbar-thumb {
+  background: #cbd5e1;
+  border-radius: 10px;
+  transition: background 0.2s;
+}
+
+#chat::-webkit-scrollbar-thumb:hover {
+  background: #94a3b8;
+}
+
+.message {
+  padding: 0.875rem 1.125rem;
+  margin-bottom: 0.75rem;
+  border-radius: 18px;
+  position: relative;
+  max-width: 75%;
+  word-wrap: break-word;
+  line-height: 1.5;
+  animation: fadeIn 0.3s ease-in;
+}
+
+@keyframes fadeIn {
+  from {
+    opacity: 0;
+    transform: translateY(10px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+.message.user {
+  background: #1e293b;
+  color: #ffffff;
+  align-self: flex-end;
+  border-bottom-right-radius: 6px;
+  box-shadow: 0 2px 8px rgba(30, 41, 59, 0.15);
+  margin-left: auto;
+}
+
+.message.agent {
+  background: #f8fafc;
+  color: #1e293b;
+  align-self: flex-start;
+  border-bottom-left-radius: 6px;
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.06);
+  border: 1px solid #e2e8f0;
+}
+
+.message.agent.typing {
+  font-style: italic;
+  color: #64748b;
+  background: #f8fafc;
+  border: 1px solid #e2e8f0;
+}
+
+.timestamp {
+  font-size: 0.7rem;
+  color: rgba(255, 255, 255, 0.7);
+  margin-top: 4px;
+  display: block;
+}
+
+.message.agent .timestamp {
+  color: #94a3b8;
+}
+
+form {
+  display: flex;
+  gap: 0.75rem;
+  align-items: center;
+}
+
+#question-input {
+  flex-grow: 1;
+  padding: 0.875rem 1.25rem;
+  font-size: 0.95rem;
+  border-radius: 16px;
+  border: 1.5px solid #e2e8f0;
+  outline: none;
+  background-color: #ffffff;
+  transition: all 0.2s ease-in-out;
+  font-family: inherit;
+}
+
+#question-input:focus {
+  border-color: #1e293b;
+  box-shadow: 0 0 0 3px rgba(30, 41, 59, 0.08);
+  background-color: #ffffff;
+}
+
+#question-input::placeholder {
+  color: #94a3b8;
+}
+
+button {
+  background: #1e293b;
+  color: white;
+  border: none;
+  border-radius: 16px;
+  padding: 0.875rem 1.5rem;
+  font-size: 0.95rem;
+  font-weight: 600;
+  cursor: pointer;
+  transition: all 0.2s ease-in-out;
+  box-shadow: 0 2px 8px rgba(30, 41, 59, 0.15);
+  white-space: nowrap;
+}
+
+button:hover {
+  background: #0f172a;
+  transform: translateY(-1px);
+  box-shadow: 0 4px 12px rgba(30, 41, 59, 0.2);
+}
+
+button:active {
+  transform: translateY(0);
+  box-shadow: 0 1px 4px rgba(30, 41, 59, 0.15);
+}
+
+button:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+  transform: none;
+}
+
+button:focus {
+  outline: 2px solid #64748b;
+  outline-offset: 2px;
+}
+
+/* Optional: Add a subtle pattern to the body */
+body::before {
+  content: "";
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  background-image: radial-gradient(
+      circle at 20% 30%,
+      rgba(148, 163, 184, 0.03) 0%,
+      transparent 50%
+    ),
+    radial-gradient(
+      circle at 80% 70%,
+      rgba(148, 163, 184, 0.03) 0%,
+      transparent 50%
+    );
+  pointer-events: none;
+  z-index: -1;
+}
+
+/* Responsive adjustments */
+@media (max-width: 640px) {
+  body {
+    padding: 1rem;
+  }
+
+  #chat-container {
+    padding: 1.5rem;
+    height: calc(100vh - 2rem);
+  }
+
+  .message {
+    max-width: 85%;
+  }
+}

agentify/ui/chat.html

@@ -0,0 +1,107 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Agentify Web UI</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Poppins:wght@500;600;700&display=swap"
+      rel="stylesheet"
+    />
+
+    <script src="ui/htmx.min.js"></script>
+    <link rel="stylesheet" href="ui/chat.css" />
+  </head>
+  <body>
+    <div id="chat-container">
+      <h2 id="chat-header">{{AGENT_NAME}}</h2>
+      <div class="tagline">
+        Model: <strong>{{AGENT_MODEL_ID}}</strong> Provider:
+        <strong>{{AGENT_PROVIDER}}</strong>
+      </div>
+      <div id="chat"></div>
+      <form
+        id="chat-form"
+        action="/ask"
+        hx-post="/ask"
+        hx-target="#chat"
+        hx-swap="beforeend"
+        method="post"
+      >
+        <input
+          id="question-input"
+          type="text"
+          name="question"
+          placeholder="Ask your agent..."
+          required
+          autocomplete="off"
+        />
+        <button type="submit">Send</button>
+      </form>
+    </div>
+
+    <script>
+      const form = document.getElementById("chat-form");
+      const input = document.getElementById("question-input");
+      const chat = document.getElementById("chat");
+
+      // Format timestamp as HH:MM
+      function getTimestamp() {
+        const now = new Date();
+        return (
+          now.getHours().toString().padStart(2, "0") +
+          ":" +
+          now.getMinutes().toString().padStart(2, "0")
+        );
+      }
+
+      // Before HTMX request: append user message, clear input, add agent typing bubble
+      form.addEventListener("htmx:beforeRequest", (evt) => {
+        const userMessage = input.value.trim();
+        if (!userMessage) return;
+
+        // Add user message immediately
+        const userBubble = document.createElement("div");
+        userBubble.className = "message user";
+        userBubble.textContent = userMessage;
+
+        // Add timestamp
+        const span = document.createElement("div");
+        span.className = "timestamp";
+        span.textContent = getTimestamp();
+        userBubble.appendChild(span);
+
+        chat.appendChild(userBubble);
+
+        // Clear input
+        input.value = "";
+
+        // Add agent typing bubble
+        const typingBubble = document.createElement("div");
+        typingBubble.className = "message agent typing";
+        typingBubble.textContent = "Agent is thinking...";
+        chat.appendChild(typingBubble);
+
+        chat.scrollTop = chat.scrollHeight;
+      });
+
+      // After HTMX swaps new content from server
+      document.body.addEventListener("htmx:afterSwap", (evt) => {
+        // Remove typing bubble
+        const typing = chat.querySelector(".message.agent.typing");
+        if (typing) typing.remove();
+
+        // Add timestamp to last message (agent)
+        const lastMessage = chat.lastElementChild;
+        if (lastMessage && !lastMessage.querySelector(".timestamp")) {
+          const span = document.createElement("div");
+          span.className = "timestamp";
+          span.textContent = getTimestamp();
+          lastMessage.appendChild(span);
+        }
+
+        chat.scrollTop = chat.scrollHeight;
+      });
+    </script>
+  </body>
+</html>