Skip to content

Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors

Rust
15.1 KB
Raw Blame
{% extends "base.html" %}

{% block title %}{{ project }} — ai-memory{% endblock %}

{% block header_search %}{% include "_header_search_scoped.html" %}{% endblock %}

{% block content %}
<nav class="breadcrumbs" aria-label="Breadcrumb"><a href=".">Projects</a><span>/</span><span>{{ workspace }}</span><span>/</span><span aria-current="page">{{ project }}</span></nav>
<div class="page-heading"><div><p class="eyebrow">PROJECT WORKSPACE</p><h1>{{ project }}</h1><p>Understand your agents, inspect their sessions, and find expensive calls.</p></div><a href="{{ inbox_href }}#compose" class="primary-button">✉ Message an agent</a></div>
<div class="project-navigation">
  <nav class="project-tabs" role="tablist" aria-label="Project sections">
    <a id="project-tab-overview" href="{{ project_href }}?tab=overview" role="tab" aria-controls="project-panel-overview" aria-selected="true" data-project-tab="overview">Overview</a>
    <a id="project-tab-agents" href="{{ project_href }}?tab=agents" role="tab" aria-controls="project-panel-agents" aria-selected="false" tabindex="-1" data-project-tab="agents">Agents</a>
    <a id="project-tab-tokens" href="{{ project_href }}?tab=tokens" role="tab" aria-controls="project-panel-tokens" aria-selected="false" tabindex="-1" data-project-tab="tokens">Token usage</a>
    <a id="project-tab-sessions" href="{{ project_href }}?tab=sessions" role="tab" aria-controls="project-panel-sessions" aria-selected="false" tabindex="-1" data-project-tab="sessions">Sessions</a>
    <a id="project-tab-knowledge" href="{{ project_href }}?tab=knowledge" role="tab" aria-controls="project-panel-knowledge" aria-selected="false" tabindex="-1" data-project-tab="knowledge">Knowledge</a>
  </nav>
  <nav class="project-tools" aria-label="Project tools"><a href="{{ inbox_href }}">Inbox <span aria-hidden="true">↗</span></a><a href="{{ graph_href }}">Link graph <span aria-hidden="true">↗</span></a></nav>
</div>
<noscript><style>.project-panel[hidden]{display:block}</style></noscript>
<section id="project-panel-overview" class="project-panel" role="tabpanel" aria-labelledby="project-tab-overview" tabindex="0">
  <div class="section-heading"><div><p class="eyebrow">AT A GLANCE</p><h2>Project overview</h2><p>Capture, activity, and pending messages. Choose a tab to explore the details.</p></div></div>
<section id="project-capture-summary" aria-label="Project capture summary" class="section-block">
  <div class="metric-grid project-memory-grid">
    <article class="metric-card"><span>Sessions</span><strong>{{ stats.session_count }}</strong><small>Registered activity</small></article>
    <article class="metric-card"><span>Captured events</span><strong>{{ stats.observation_count }}</strong><small>Sanitized observations</small></article>
    <article class="metric-card"><span>Compiled pages</span><strong>{{ stats.page_count }}</strong><small>Knowledge for recall</small></article>
    <article class="metric-card metric-attention"><span>Open sessions</span><strong>{{ stats.open_session_count }}</strong><small>No end event received</small></article>
    <article class="metric-card"><span>Tokens (in / out)</span><strong style="font-size:23px">{{ stats.tokens_total }}</strong><small>Reported session totals</small></article>
  </div>
  <p class="mt-4 text-xs text-slate-500 dark:text-slate-400">
    {% if stats.last_activity_relative != "" %}Last capture {{ stats.last_activity_relative }}. {% endif %}
    {% if stats.open_session_count > 0 %}Open means no SessionEnd was received; it may be an active agent or an interruption.{% else %}No currently open session is recorded.{% endif %}
  </p>
  {% if !by_agent.is_empty() %}
  <div class="mt-4 flex flex-wrap items-center gap-2 border-t border-slate-200 dark:border-slate-800 pt-4">
    <span class="text-xs text-slate-500 dark:text-slate-400">Agents:</span>
    {% for badge in by_agent %}
    <span class="inline-flex items-center gap-1 rounded-full px-2 py-0.5 text-xs font-medium bg-blue-50 dark:bg-blue-950/40 text-blue-700 dark:text-blue-300 border border-blue-100 dark:border-blue-900">
      {{ badge.label }} <span class="text-blue-500 dark:text-blue-400">· {{ badge.count }}</span>
    </span>
    {% endfor %}
  </div>
  {% endif %}
</section>
    <section class="surface panel-heading" aria-labelledby="mailbox-heading">
      <div class="flex items-center gap-2 mb-3">
        <a href="{{ inbox_href }}" class="secondary-button" style="float:right">Open inbox ↗</a><h2 id="mailbox-heading" class="text-xs font-semibold uppercase tracking-wide text-slate-500 dark:text-slate-400">Mailbox</h2>
        {% if !mailbox.is_empty() %}
        <span class="inline-flex items-center rounded px-1.5 py-0.5 text-xs font-medium border border-amber-200 dark:border-amber-900/50 bg-amber-50 dark:bg-amber-950/30 text-amber-800 dark:text-amber-300">{% if mailbox_capped %}{{ mailbox.len() }} of {{ mailbox_total }}{% else %}{{ mailbox_total }}{% endif %} pending</span>
        {% endif %}
      </div>
      {% if mailbox.is_empty() %}
      <p class="text-sm text-slate-500 dark:text-slate-400">No pending messages for this project.</p>
      {% else %}
      <ul class="divide-y divide-slate-100 dark:divide-slate-800">
        {% for message in mailbox %}
        <li class="py-3 flex items-start justify-between gap-4">
          <div class="min-w-0">
            <div class="text-sm font-medium text-slate-800 dark:text-slate-100 truncate">{{ message.subject }}</div>
            <div class="flex items-center gap-2 mt-1">
              {% if let Some(href) = message.sender_href %}
              <a href="{{ href }}" class="inline-flex items-center rounded px-1.5 py-0.5 text-xs font-medium bg-slate-100 dark:bg-slate-800 text-slate-600 dark:text-slate-400 hover:text-blue-600 dark:hover:text-blue-400 shrink-0">from {{ message.sender }}</a>
              {% else %}
              <span class="inline-flex items-center rounded px-1.5 py-0.5 text-xs font-medium bg-slate-100 dark:bg-slate-800 text-slate-600 dark:text-slate-400 shrink-0">from {{ message.sender }}</span>
              {% endif %}
              <span class="inline-flex items-center rounded px-1.5 py-0.5 text-xs font-medium border border-slate-200 dark:border-slate-700 text-slate-600 dark:text-slate-400 shrink-0">{{ message.nature }}</span>
              <span class="text-xs text-slate-500 dark:text-slate-400 truncate">{{ message.snippet }}</span>
            </div>
          </div>
          <span class="text-xs text-slate-500 dark:text-slate-400 whitespace-nowrap shrink-0">{{ message.created_relative }}</span>
        </li>
        {% endfor %}
      </ul>
      <p class="mt-2 text-xs text-slate-500 dark:text-slate-400">
        {% if mailbox_capped %}Showing the oldest {{ mailbox.len() }} of {{ mailbox_total }}; <code class="font-mono">ai-memory message list --workspace {{ workspace }} --project {{ project }} --limit 200</code> lists up to 200. {% endif %}An agent in this project reads them with <code class="font-mono">memory_message_pop</code>.
      </p>
      {% endif %}
    </section>
</section>
<section id="project-panel-agents" class="project-panel" role="tabpanel" aria-labelledby="project-tab-agents" tabindex="0" hidden>
{% include "_agent_cards.html" %}
</section>
<section id="project-panel-tokens" class="project-panel" role="tabpanel" aria-labelledby="project-tab-tokens" tabindex="0" hidden>
{% include "_usage_panel.html" %}
</section>
<section id="project-panel-knowledge" class="project-panel" role="tabpanel" aria-labelledby="project-tab-knowledge" tabindex="0" hidden>
<div class="section-heading"><div><p class="eyebrow">COMPILED MEMORY</p><h2>Knowledge</h2><p>Browse saved pages or search this project's memory.</p></div></div>
<div id="knowledge" class="surface knowledge-layout">
  <form action="search" method="get" class="knowledge-search">
    <input type="hidden" name="workspace" value="{{ workspace }}"><input type="hidden" name="project" value="{{ project }}">
    <label for="project-search-q" class="sr-only">Search this project's memory</label><input id="project-search-q" name="q" type="search" class="field-input" placeholder="Search project memory…"><button type="submit" class="secondary-button">Search</button>
  </form>
  <!-- Sidebar: folder tree -->
  <aside aria-label="Project pages">
    <h2 class="text-xs font-semibold uppercase tracking-wide text-slate-500 dark:text-slate-400 mb-3">Pages</h2>
    {% if folders.is_empty() %}
    <p class="text-sm text-slate-400 dark:text-slate-600">No compiled pages yet.</p>
    {% else %}
    <ul class="space-y-1">
      {% for folder in folders %}
      <li>
        <div class="text-xs font-medium text-slate-500 dark:text-slate-400 py-1 border-b border-slate-100 dark:border-slate-800 mb-1">
          {% if let Some(href) = folder.href %}<a href="{{ href }}" class="hover:text-blue-600 dark:hover:text-blue-400">{{ folder.name }}/</a>{% else %}{{ folder.name }}/{% endif %}
          <span class="font-normal">({{ folder.total }})</span>
        </div>
        <ul class="space-y-0.5 pl-2">
          {% for page in folder.pages %}
          <li>
            <a href="{{ page.href }}"
               class="block truncate text-sm text-slate-700 dark:text-slate-300 hover:text-blue-600 dark:hover:text-blue-400 py-0.5">
              {{ page.title }}
            </a>
          </li>
          {% endfor %}
          {% if let Some(href) = folder.href %}{% if folder.total > folder.pages.len() %}
          <li><a href="{{ href }}" class="block text-xs text-blue-600 dark:text-blue-400 hover:underline py-0.5">View all {{ folder.total }}</a></li>
          {% endif %}{% endif %}
        </ul>
      </li>
      {% endfor %}
    </ul>
    {% endif %}
    {% if !system.is_empty() %}
    <details class="mt-6">
      <summary class="text-xs font-semibold uppercase tracking-wide text-slate-500 dark:text-slate-400 cursor-pointer select-none">System</summary>
      <ul class="space-y-1 mt-3">
        {% for folder in system %}
        <li>
          <div class="text-xs font-medium text-slate-500 dark:text-slate-400 py-1 border-b border-slate-100 dark:border-slate-800 mb-1">
            {% if let Some(href) = folder.href %}<a href="{{ href }}" class="hover:text-blue-600 dark:hover:text-blue-400">{{ folder.name }}/</a>{% else %}{{ folder.name }}/{% endif %}
            <span class="font-normal">({{ folder.total }})</span>
          </div>
          <ul class="space-y-0.5 pl-2">
            {% for page in folder.pages %}
            <li>
              <a href="{{ page.href }}"
                 class="block truncate text-sm text-slate-500 dark:text-slate-400 hover:text-blue-600 dark:hover:text-blue-400 py-0.5">
                {{ page.title }}
              </a>
            </li>
            {% endfor %}
            {% if let Some(href) = folder.href %}{% if folder.total > folder.pages.len() %}
            <li><a href="{{ href }}" class="block text-xs text-blue-600 dark:text-blue-400 hover:underline py-0.5">View all {{ folder.total }}</a></li>
            {% endif %}{% endif %}
          </ul>
        </li>
        {% endfor %}
      </ul>
    </details>
    {% endif %}
  </aside>

  <!-- Main: recent pages -->
  <div class="flex-1 min-w-0">
    <h2 class="text-xs font-semibold uppercase tracking-wide text-slate-500 dark:text-slate-400 mb-3">Recent Activity</h2>
    {% if recent.is_empty() %}
    <div class="rounded-lg border border-dashed border-slate-300 dark:border-slate-700 p-5 text-sm text-slate-500 dark:text-slate-400">
      <p class="font-medium text-slate-700 dark:text-slate-200">No compiled memory pages yet.</p>
      {% if stats.session_count > 0 %}
      <p class="mt-2">This project has {{ stats.session_count }} captured session{% if stats.session_count != 1 %}s{% endif %} and {{ stats.observation_count }} sanitized event{% if stats.observation_count != 1 %}s{% endif %}. Pages appear after consolidation; agents can still retrieve current context through MCP.</p>
      {% else %}
      <p class="mt-2">No capture has been received for this project yet. Start an agent session with the hook enabled, then return after its observations are consolidated.</p>
      {% endif %}
    </div>
    {% else %}
    <ul class="divide-y divide-slate-100 dark:divide-slate-800">
      {% for page in recent %}
      <li class="py-3 flex items-start justify-between gap-4">
        <div class="min-w-0">
          <a href="{{ page.href }}"
             class="text-sm font-medium text-slate-800 dark:text-slate-100 hover:text-blue-600 dark:hover:text-blue-400 truncate block">
            {{ page.title }}
          </a>
          <div class="flex items-center gap-2 mt-1">
            <span class="inline-flex items-center rounded px-1.5 py-0.5 text-xs font-medium bg-slate-100 dark:bg-slate-800 text-slate-600 dark:text-slate-400">
              {{ page.kind }}
            </span>
            {% if let Some(agent) = page.agent_label %}
            <span class="inline-flex items-center rounded px-1.5 py-0.5 text-xs font-medium bg-blue-50 dark:bg-blue-950/40 text-blue-700 dark:text-blue-300">
              {{ agent }}
            </span>
            {% endif %}
            <span class="text-xs text-slate-400 dark:text-slate-500 truncate">{{ page.path }}</span>
          </div>
        </div>
        <span class="text-xs text-slate-500 dark:text-slate-400 whitespace-nowrap shrink-0">{{ page.updated_relative }}</span>
      </li>
      {% endfor %}
    </ul>
    {% endif %}
  </div>
</div>

</section>
<section id="project-panel-sessions" class="project-panel" role="tabpanel" aria-labelledby="project-tab-sessions" tabindex="0" hidden>
<div id="session-token-table" class="surface section-block">
  <div class="section-heading panel-heading"><div><p class="eyebrow">RECENT ACTIVITY</p><h2>Sessions</h2><p>Open a session to inspect its model responses and captured events.</p></div></div>
  {% if sessions.is_empty() %}
  <p class="text-sm text-slate-400 dark:text-slate-600">No sessions recorded yet.</p>
  {% else %}
  <div class="rounded-lg border border-slate-200 dark:border-slate-800 overflow-x-auto">
    <table class="sessions-table ops-table">
      <thead class="border-b border-slate-200 dark:border-slate-800 text-slate-500 dark:text-slate-400">
        <tr>
          <th>Agent</th>
          <th>Started</th>
          <th>Duration</th>
          <th>Events</th>
          <th>Tokens</th>
        </tr>
      </thead>
      <tbody class="divide-y divide-slate-100 dark:divide-slate-800">
        {% for session in sessions %}
        <tr data-session-agent="{{ session.agent_kind }}">
          <td>
            <span class="inline-flex items-center rounded px-1.5 py-0.5 text-xs font-medium bg-blue-50 dark:bg-blue-950/40 text-blue-700 dark:text-blue-300">
              <a href="{{ session.href }}" class="hover:underline">{{ session.agent_label }}</a>
            </span>
          </td>
          <td class="text-slate-500 dark:text-slate-400">{{ session.started_relative }}</td>
          <td class="text-slate-500 dark:text-slate-400">{{ session.duration }}</td>
          <td class="text-slate-500 dark:text-slate-400">{{ session.observation_count }}</td>
          <td class="text-slate-600 dark:text-slate-300">{{ session.tokens }}</td>
        </tr>
        {% endfor %}
      </tbody>
    </table>
  </div>
  {% endif %}
</div>
</section>
{% include "_project_tabs_script.html" %}
{% include "_dashboard_refresh.html" %}
{% endblock %}