agent-memory-brain 0.2.0__py3-none-any.whl

devmem/panel/templates/subagent.html

@@ -0,0 +1,27 @@
+{% extends 'base.html' %}
+{% block title %}Subagent · Brain{% endblock %}
+{% block body %}
+<h1>{{ agent.agent_type or 'subagent' }}</h1>
+<p class="muted back-row">{% if agent.thread_id %}<a href="/messages?chat={{ ('s:' ~ agent.session_id) | urlencode }}">Back to chat</a><a href="/messages/thread/{{ agent.thread_id }}">Thread</a>{% endif %}<span>{{ agent.description or '' }}</span></p>
+<div class="grid-cards">
+  <div class="card"><div class="stat-label">Status</div><div class="stat-value"><span class="badge st-{{ agent.status }}">{{ agent.status }}</span></div></div>
+  <div class="card"><div class="stat-label">Started</div><div><time data-rel datetime="{{ agent.started_at }}">{{ agent.started_at }}</time></div>
+    <div class="stat-label stat-gap">Last activity</div><div><time data-rel datetime="{{ agent.last_activity_at }}">{{ agent.last_activity_at }}</time></div></div>
+  <div class="card"><div class="stat-label">Tokens</div><div class="stat-value" data-tokens="{{ agent.tokens }}">{{ agent.tokens }}</div></div>
+  <div class="card"><div class="stat-label">Parent session</div><div class="mono"><a href="/sessions/{{ agent.session_id }}">{{ agent.session_id }}</a></div>
+    {% if agent.project %}<div class="muted mono">{{ agent.project }}</div>{% endif %}</div>
+</div>
+<h2>Task</h2>
+<pre class="card msg-body">{{ agent.task or 'No task recorded.' }}</pre>
+<h2>Tool calls</h2>
+<table><thead><tr><th>Time</th><th>Tool</th><th>Argument</th></tr></thead><tbody>
+{% for t in agent.tools %}<tr><td><time data-rel datetime="{{ t.ts }}">{{ t.ts }}</time></td><td class="mono">{{ t.name }}</td><td class="mono muted">{{ t.arg }}</td></tr>
+{% else %}<tr><td colspan="3" class="muted">No tool calls yet.</td></tr>{% endfor %}
+</tbody></table>
+{% if agent.texts %}<h2>Remarks</h2>
+<table><thead><tr><th>Time</th><th>From</th><th>Text</th></tr></thead><tbody>
+{% for t in agent.texts %}<tr><td><time data-rel datetime="{{ t.ts }}">{{ t.ts }}</time></td><td class="muted">{{ 'parent' if t.role == 'parent' else 'agent' }}</td><td class="msg-body">{{ t.body }}</td></tr>{% endfor %}
+</tbody></table>{% endif %}
+<h2>Report</h2>
+<pre class="card msg-body">{% if agent.report %}{{ agent.report }}{% elif agent.status == 'stopped' %}No report: the agent stopped (no write for 2 hours) without finishing.{% else %}Still {{ agent.status }}; the report appears when it finishes.{% endif %}</pre>
+{% endblock %}

devmem/procs.py

@@ -0,0 +1,10 @@
+"""Small helpers for starting external processes."""
+from __future__ import annotations
+
+import os
+import shutil
+
+
+def executable(name: str) -> str:
+    """Return a resolved executable path on Windows, otherwise preserve ``name``."""
+    return shutil.which(name) or name if os.name == "nt" else name

devmem/projects.py

@@ -0,0 +1,17 @@
+"""Project-path helpers that are safe for hooks to import."""
+from __future__ import annotations
+
+from functools import lru_cache
+from pathlib import Path
+
+
+@lru_cache(maxsize=1024)
+def project_for_cwd(cwd: str | None) -> str | None:
+    """Return git root for cwd, without invoking git; walk for a .git marker."""
+    if not cwd:
+        return None
+    current = Path(cwd).expanduser().resolve()
+    for candidate in (current, *current.parents):
+        if (candidate / ".git").exists():
+            return str(candidate)
+    return str(current)

devmem/secrets.py

@@ -0,0 +1,9 @@
+"""Shared secret-redaction patterns, kept free of operational dependencies."""
+from __future__ import annotations
+
+import re
+
+
+SECRET = re.compile(r"BEGIN [A-Z ]*PRIVATE KEY|\b(?:gh[pousr]_[A-Za-z0-9]{20,}|github_pat_\w{20,}|sk-(?:proj-|ant-)?[\w-]{20,}|[sr]k_(?:live|test)_\w{10,}"
+                    r"|AKIA[0-9A-Z]{16}|xox[abposr]-[A-Za-z0-9-]{10,}|eyJ[\w-]{8,}\.eyJ[\w-]{8,}\.[\w-]{8,})|\bBearer\s+[\w.~+/=-]{16,}"
+                    r"|(?:api[_-]?key|access[_-]?key|token|secret|passw(?:or)?d|pwd)\s*[:=]\s*['\"]?[A-Za-z0-9_./+=-]{8,}", re.I)

devmem/skills.py

@@ -0,0 +1,105 @@
+"""Small, dependency-free loader and installer for repository coding skills."""
+from __future__ import annotations
+
+import os
+import sys
+from pathlib import Path
+
+
+def skills_dir() -> Path:
+    """Return the configured skills directory, or this repository's skills directory."""
+    configured = os.environ.get("DEVMEM_SKILLS_DIR")
+    return Path(configured).expanduser().resolve() if configured else (Path(__file__).resolve().parent.parent / "skills")
+
+
+def _skill(path: Path) -> dict:
+    try:
+        lines = path.read_text(encoding="utf-8").splitlines()
+    except OSError as exc:
+        raise ValueError(str(exc)) from exc
+    if not lines or lines[0] != "---":
+        raise ValueError("frontmatter must start with ---")
+    try:
+        end = lines.index("---", 1)
+    except ValueError as exc:
+        raise ValueError("frontmatter is not closed") from exc
+    fields = {}
+    for line in lines[1:end]:
+        if not line.strip():
+            continue
+        if ":" not in line:
+            raise ValueError("frontmatter line must be key: value")
+        key, value = line.split(":", 1)
+        if not key.strip() or not value.strip():
+            raise ValueError("frontmatter line must be key: value")
+        fields[key.strip()] = value.strip()
+    for key in ("name", "description", "devmem-briefing"):
+        if key not in fields:
+            raise ValueError(f"missing {key}")
+    if fields["devmem-briefing"] not in ("true", "false"):
+        raise ValueError("devmem-briefing must be true or false")
+    try:
+        summary_start = lines.index("## Summary", end + 1) + 1
+    except ValueError as exc:
+        raise ValueError("missing ## Summary") from exc
+    summary_lines = []
+    for line in lines[summary_start:]:
+        if line.startswith("## "):
+            break
+        summary_lines.append(line)
+    summary = "\n".join(summary_lines).strip()
+    if not summary:
+        raise ValueError("empty ## Summary")
+    return {"name": fields["name"], "description": fields["description"],
+            "briefing": fields["devmem-briefing"] == "true", "summary": summary,
+            "path": str(path.resolve())}
+
+
+def list_skills() -> dict:
+    """Return valid repository skills and reports for malformed skill files."""
+    skills, invalid = [], []
+    try:
+        paths = sorted(skills_dir().glob("*/SKILL.md"))
+    except OSError as exc:
+        return {"skills": [], "invalid": [{"path": str(skills_dir()), "reason": str(exc)}]}
+    for path in paths:
+        try:
+            skills.append(_skill(path))
+        except ValueError as exc:
+            invalid.append({"path": str(path.resolve()), "reason": str(exc)})
+    return {"skills": skills, "invalid": invalid}
+
+
+def briefing_text() -> str:
+    """Render the compact skill text included in agent briefings."""
+    briefing = [skill for skill in list_skills()["skills"] if skill["briefing"]]
+    if not briefing:
+        return ""
+    entries = []
+    for skill in briefing:
+        entries.append(f"{skill['summary']}\nFull text: skill {skill['name']} ({skill['path']})")
+    return "## Coding guidelines\n" + "\n\n".join(entries)
+
+
+def install(target: Path, dry_run: bool = False) -> bool:
+    """Install skills as directory symlinks, returning false when a conflict exists."""
+    data = list_skills()
+    failed = False
+    for skill in data["skills"]:
+        source = Path(skill["path"]).parent
+        destination = target / skill["name"]
+        if destination.is_symlink() and destination.resolve() == source.resolve():
+            print(f"ok {destination}")
+        elif destination.exists() or destination.is_symlink():
+            print(f"warning: {destination} exists; not touching it", file=sys.stderr)
+            failed = True
+        elif dry_run:
+            print(f"link {destination} -> {source}")
+        else:
+            target.mkdir(parents=True, exist_ok=True)
+            destination.symlink_to(source, target_is_directory=True)
+            print(f"linked {destination} -> {source}")
+    for item in data["invalid"]:
+        print(f"invalid {item['path']}: {item['reason']}", file=sys.stderr)
+        failed = True
+    return not failed