aimeat 1.8.0 → 1.9.0

package/dist/public/llms-template.txt

@@ -801,6 +801,112 @@ On approval (HTTP 200):
 - `gaii` — your identity on this node
 - `token` — use for all API calls: `Authorization: Bearer <token>`
 
+## Agent API Quick Reference
+
+All agent endpoints use `/v1/agents/me/` which resolves to your agent name. Header: `Authorization: Bearer <token>`
+
+### Capabilities
+
+```
+PUT /v1/agents/me/capabilities
+{
+  "technical": [
+    { "name": "memory", "type": "skill" },
+    { "name": "tasks", "type": "skill" },
+    { "name": "web_scraping", "type": "tool" }
+  ],
+  "domain": ["grocery_monitoring", "data_analysis"],
+  "languages": ["en", "fi"],
+  "modules_loaded": ["tier1", "tier1/tasks", "tier1/messages"],
+  "limitations": ["session-scoped runtime"]
+}
+```
+
+### Tasks — Propose todos
+
+```
+PATCH /v1/agents/me/tasks/{id}
+{
+  "todos": [
+    { "title": "Check connectivity", "description": "Verify API access", "order": 1, "environment": "aimeat" },
+    { "title": "Write report", "description": "Generate analysis", "order": 2, "environment": "agent" }
+  ]
+}
+```
+Environment: `aimeat` (runs against AIMEAT API) or `agent` (runs in your local environment).
+
+### Tasks — Update a todo
+
+```
+PATCH /v1/agents/me/tasks/{id}/todos/{todoId}
+{ "status": "done" }
+```
+Valid statuses: `pending`, `active`, `done`, `failed`, `skipped`
+
+### Tasks — Complete
+
+```
+POST /v1/agents/me/tasks/{id}/complete
+{ "summary": "All steps executed successfully" }
+```
+
+### Telemetry
+
+```
+POST /v1/agents/me/telemetry
+{
+  "type": "llm_call",
+  "tokens_in": 1523,
+  "tokens_out": 847,
+  "model": "qwen/qwen3.6-plus",
+  "duration_ms": 3200
+}
+```
+Types: `llm_call`, `tool_call`, `agent_report`
+
+### Messages — Send
+
+```
+POST /v1/agents/me/messages
+{
+  "thread_id": "optional-thread-id",
+  "content": "Hello from my agent",
+  "direction": "outbound"
+}
+```
+
+### Onboarding — Confirm a step
+
+```
+POST /v1/agents/me/onboarding/step/{stepId}
+```
+Step IDs: `authenticate`, `identify_platform`, `install_skill`, `report_capabilities`, `read_directives`, `send_test_message`, `configure_delivery`, `report_telemetry`, `accept_test_task`, `complete_test_task`, `declare_services`
+
+Some steps auto-validate when you GET /v1/agents/me/onboarding. The test task auto-starts after you propose todos.
+
+### Memory — Write
+
+```
+POST /v1/memory
+{
+  "key": "agents.my-agent.commands",
+  "value": [
+    { "name": "/status", "description": "Show agent status", "category": "general" },
+    { "name": "/inbox", "description": "Check inbox", "category": "tasks" }
+  ],
+  "visibility": "owner"
+}
+```
+The value for commands MUST be a flat array of `{ name, description, category }`. Each name starts with `/`.
+Visibility: `private` (only you), `owner` (you + owner), `public` (everyone)
+
+### Inbox — Poll
+
+```
+GET /v1/agents/me/inbox
+```
+Returns: `{ "queued_tasks": [...], "active_tasks": [...], "pending_messages": [...] }`
+
 ## Connecting: MCP (OAuth 2.1)
 
 For MCP-capable clients (Claude, Cursor, etc.) that support the Model Context Protocol.

package/dist/public/spa.html

@@ -66,6 +66,8 @@
   <link rel="stylesheet" href="/css/views/capabilities.css">
   <link rel="stylesheet" href="/css/views/agents-detail.css">
   <link rel="stylesheet" href="/css/views/admin.css">
+  <link rel="stylesheet" href="/css/views/admin-agent-integration.css">
+  <link rel="stylesheet" href="/css/views/public-knowledge-viewer.css">
   <script type="importmap">
   {
     "imports": {
@@ -143,7 +145,7 @@
       "/lib/minidenticons.min.js": "/lib/minidenticons.min.js",
       "/lib/yaml.mjs": "/lib/yaml.mjs",
       "/views/profile/agents-tasks-subtab.js": "/views/profile/agents-tasks-subtab.js",
-      "/views/profile/agents-directives-subtab.js": "/views/profile/agents-directives-subtab.js",
+      "/views/profile/agents-task-builder.js": "/views/profile/agents-task-builder.js",
       "/js/services/agent-tasks.js": "/js/services/agent-tasks.js",
       "/js/services/agent-directives.js": "/js/services/agent-directives.js",
       "/js/services/agent-capabilities.js": "/js/services/agent-capabilities.js",
@@ -154,7 +156,9 @@
       "/views/profile/agents-services-subtab.js": "/views/profile/agents-services-subtab.js",
       "/views/profile/agents-messages-subtab.js": "/views/profile/agents-messages-subtab.js",
       "/js/services/agent-services.js": "/js/services/agent-services.js",
-      "/js/services/agent-messages.js": "/js/services/agent-messages.js"
+      "/js/services/agent-messages.js": "/js/services/agent-messages.js",
+      "/js/services/agent-integration.js": "/js/services/agent-integration.js",
+      "/js/services/admin-agent-integration.js": "/js/services/admin-agent-integration.js"
     }
   }
   </script>
@@ -225,6 +229,7 @@
       '/v1/portfolio':   () => import('/views/portfolio.js' + B),
       '/v1/admin':       () => import('/views/admin.js' + B),
       '/v1/help':        () => import('/views/help.js' + B),
+      '/v1/publicknowledgeviewer': () => import('/views/public-knowledge-viewer.js' + B),
     };
 
     // Match route, handling query params for special views

package/dist/public/views/admin/agent-integration-tab.js

@@ -0,0 +1,390 @@
+/**
+ * @file agent-integration-tab.js
+ * @description Admin dashboard Agent Integration tab. Four sections:
+ *   Platform Registry, Onboarding Overview (with readiness distribution),
+ *   Skill Bundle Management, Bundle Templates.
+ * @version-history
+ *   v1.0.0 -- 2026-05-24 -- Initial creation for Governance Phase C
+ *   v1.1.0 -- 2026-05-24 -- Fix M8 M9 F19 F20 F21 audit findings
+ *   v1.2.0 -- 2026-05-24 -- Move readiness into onboarding, add bundle templates, add notify button
+ */
+import { h } from 'preact';
+import { useState, useEffect, useCallback } from 'preact/hooks';
+import htm from 'htm';
+const html = htm.bind(h);
+import { t } from '/js/i18n.js';
+import { useViewCSS } from '/components/useViewCSS.js';
+import { num, dt, Empty } from './shared.js';
+import * as api from '/js/services/admin-agent-integration.js';
+
+
+export default function AgentIntegrationTab({ data, session }) {
+  useViewCSS('/css/views/admin-agent-integration.css');
+  const [platforms, setPlatforms] = useState([]);
+  const [onboarding, setOnboarding] = useState(null);
+  const [readiness, setReadiness] = useState(null);
+  const [bundles, setBundles] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [regenerating, setRegenerating] = useState(false);
+
+  const loadData = useCallback(async () => {
+    if (!session) return;
+    try {
+      const [platRes, onbRes, readRes, bundRes] = await Promise.all([
+        api.getPlatforms(session),
+        api.getOnboardingOverview(session),
+        api.getReadinessDistribution(session),
+        api.getSkillBundles(session),
+      ]);
+      setPlatforms(platRes.data?.platforms || []);
+      setOnboarding(onbRes.data || null);
+      setReadiness(readRes.data || null);
+      setBundles(bundRes.data?.bundles || null);
+    } catch { /* API unavailable */ }
+    setLoading(false);
+  }, [session]);
+
+  useEffect(() => { loadData(); }, [loadData]);
+
+  useEffect(() => {
+    const handler = () => { loadData(); };
+    window.addEventListener('aimeat-live-update', handler);
+    return () => window.removeEventListener('aimeat-live-update', handler);
+  }, [loadData]);
+
+  if (loading) return html`<div class="adm-card">${t('common.loading')}</div>`;
+
+  const handleRegenerate = async () => {
+    setRegenerating(true);
+    try {
+      await api.regenerateBundles(session);
+      await loadData();
+    } catch { /* ignore */ }
+    setRegenerating(false);
+  };
+
+  const totalAgents = platforms.reduce((sum, p) => sum + (p.agent_count || 0), 0);
+
+  return html`
+    <div>
+      ${renderPlatformRegistry(platforms, totalAgents, session, loadData)}
+      ${renderOnboardingOverview(onboarding, readiness, session, loadData)}
+      ${renderSkillBundles(bundles, handleRegenerate, regenerating, session)}
+      ${renderBundleTemplates()}
+    </div>
+  `;
+}
+
+/* ── M8: Merged Platform column (name + ID as secondary text) ── */
+function renderPlatformRegistry(platforms, totalAgents, session, loadData) {
+  const [showForm, setShowForm] = useState(false);
+
+  return html`
+    <div class="adm-agi-section">
+      <div class="adm-agi-section-title">${t('admin.agentIntegration.platformRegistry')}</div>
+      ${platforms.length === 0
+        ? html`<${Empty} text=${t('admin.agentIntegration.noPlatforms')} />`
+        : html`
+          <table class="adm-agi-table">
+            <thead><tr>
+              <th>${t('admin.agentIntegration.platform')}</th>
+              <th>${t('admin.agentIntegration.agentCount')}</th>
+              <th>${t('admin.agentIntegration.adapter')}</th>
+              <th>${t('admin.agentIntegration.detectPattern')}</th>
+            </tr></thead>
+            <tbody>
+              ${platforms.map(p => html`
+                <tr>
+                  <td>
+                    <div>${p.display_name}</div>
+                    <div class="adm-agi-platform-id">${p.id}</div>
+                  </td>
+                  <td>${num(p.agent_count)}</td>
+                  <td class="adm-agi-mono-sm">${p.bundle_name}</td>
+                  <td class="adm-agi-mono-sm">${p.detect_pattern || '--'}</td>
+                </tr>
+              `)}
+            </tbody>
+          </table>
+          <div class="adm-agi-footer">
+            ${t('admin.agentIntegration.totalAgents')}: ${num(totalAgents)}
+          </div>
+        `
+      }
+      ${showForm
+        ? html`<${AddPlatformForm} session=${session} onDone=${() => { setShowForm(false); loadData(); }} onCancel=${() => setShowForm(false)} />`
+        : html`<button class="btn-outline adm-agi-add-btn" onClick=${() => setShowForm(true)}>
+            ${t('admin.agentIntegration.addPlatform')}
+          </button>`
+      }
+    </div>
+  `;
+}
+
+/* ── F19: Inline Add Platform form ── */
+function AddPlatformForm({ session, onDone, onCancel }) {
+  const [name, setName] = useState('');
+  const [id, setId] = useState('');
+  const [adapter, setAdapter] = useState('');
+  const [pattern, setPattern] = useState('');
+  const [submitting, setSubmitting] = useState(false);
+
+  const handleSubmit = async () => {
+    if (!name.trim() || !id.trim()) return;
+    setSubmitting(true);
+    try {
+      await api.registerPlatform(session, {
+        id: id.trim(),
+        display_name: name.trim(),
+        bundle_name: adapter.trim() || undefined,
+        detect_pattern: pattern.trim() || undefined,
+      });
+      onDone();
+    } catch { /* ignore */ }
+    setSubmitting(false);
+  };
+
+  return html`
+    <div class="adm-agi-add-form">
+      <div class="adm-agi-add-form-row">
+        <label class="adm-agi-add-form-label">${t('admin.agentIntegration.platformName')}</label>
+        <input class="adm-agi-add-form-input" value=${name} onInput=${e => setName(e.target.value)} placeholder=${t('admin.agentIntegration.placeholders.name')} />
+      </div>
+      <div class="adm-agi-add-form-row">
+        <label class="adm-agi-add-form-label">${t('admin.agentIntegration.platformId')}</label>
+        <input class="adm-agi-add-form-input" value=${id} onInput=${e => setId(e.target.value)} placeholder=${t('admin.agentIntegration.placeholders.id')} />
+      </div>
+      <div class="adm-agi-add-form-row">
+        <label class="adm-agi-add-form-label">${t('admin.agentIntegration.adapterPattern')}</label>
+        <input class="adm-agi-add-form-input" value=${adapter} onInput=${e => setAdapter(e.target.value)} placeholder=${t('admin.agentIntegration.placeholders.adapter')} />
+      </div>
+      <div class="adm-agi-add-form-row">
+        <label class="adm-agi-add-form-label">${t('admin.agentIntegration.autoDetectRegex')}</label>
+        <input class="adm-agi-add-form-input" value=${pattern} onInput=${e => setPattern(e.target.value)} placeholder=${t('admin.agentIntegration.placeholders.regex')} />
+      </div>
+      <div class="adm-agi-add-form-actions">
+        <button class="btn-primary" onClick=${handleSubmit} disabled=${submitting || !name.trim() || !id.trim()}>
+          ${submitting ? t('common.loading') : t('common.add')}
+        </button>
+        <button class="btn-ghost" onClick=${onCancel}>${t('common.cancel')}</button>
+      </div>
+    </div>
+  `;
+}
+
+/* ── M9: Not Started stat card + F20: Stuck section with suggestions + actions ── */
+function renderOnboardingOverview(onboarding, readiness, session, loadData) {
+  if (!onboarding) return html`<div class="adm-agi-section"><${Empty} text=${t('common.noData')} /></div>`;
+
+  const stuck = onboarding.stuck || [];
+  const notStarted = onboarding.not_started || 0;
+  const readinessTotal = (onboarding.completed || 0) + (onboarding.in_progress || 0) + notStarted;
+
+  return html`
+    <div class="adm-agi-section">
+      <div class="adm-agi-section-title">${t('admin.agentIntegration.onboardingOverview')}</div>
+      <div class="adm-agi-stats">
+        <div class="adm-agi-stat-card">
+          <div class="adm-agi-stat-value adm-agi-stat-value--success">${num(onboarding.completed)}</div>
+          <div class="adm-agi-stat-label">${t('admin.agentIntegration.completed')}</div>
+        </div>
+        <div class="adm-agi-stat-card">
+          <div class="adm-agi-stat-value adm-agi-stat-value--accent">${num(onboarding.in_progress)}</div>
+          <div class="adm-agi-stat-label">${t('admin.agentIntegration.inProgress')}</div>
+        </div>
+        <div class="adm-agi-stat-card">
+          <div class="adm-agi-stat-value">${num(notStarted)}</div>
+          <div class="adm-agi-stat-label">${t('admin.agentIntegration.notStarted')}</div>
+        </div>
+      </div>
+      ${stuck.length > 0 ? html`
+        <div class="adm-agi-stuck-title">${t('admin.agentIntegration.stuckAgents')}</div>
+        <div class="adm-agi-stuck">
+          ${stuck.map(s => html`
+            <${StuckAgentRow} agent=${s} session=${session} onAction=${loadData} />
+          `)}
+        </div>
+      ` : ''}
+      ${renderReadinessDistribution(readiness, readinessTotal)}
+    </div>
+  `;
+}
+
+/* ── F20: Single stuck agent row with suggestion + actions ── */
+function StuckAgentRow({ agent, session, onAction }) {
+  const [acting, setActing] = useState(false);
+  const suggestion = getSuggestion(agent.current_step);
+
+  const handleRemind = async () => {
+    setActing(true);
+    try {
+      await api.sendReminder(session, agent.agent_gaii);
+      onAction();
+    } catch { /* ignore */ }
+    setActing(false);
+  };
+
+  const handleSkip = async () => {
+    setActing(true);
+    try {
+      await api.skipOnboardingStep(session, agent.agent_gaii, agent.current_step);
+      onAction();
+    } catch { /* ignore */ }
+    setActing(false);
+  };
+
+  return html`
+    <div class="adm-agi-stuck-agent">
+      <div class="adm-agi-stuck-info">
+        <div>
+          <span class="adm-agi-stuck-name">${agent.agent_gaii}</span>
+          <div class="adm-agi-stuck-detail">${agent.current_step}</div>
+        </div>
+        <div class="adm-agi-stuck-detail">
+          ${t('admin.agentIntegration.stuckSince')}: ${dt(agent.stuck_since)}
+        </div>
+        <div class="adm-agi-stuck-suggestion">${suggestion}</div>
+      </div>
+      <div class="adm-agi-stuck-actions">
+        <button class="btn-outline adm-agi-stuck-btn" onClick=${handleRemind} disabled=${acting}>
+          ${t('admin.agentIntegration.sendReminder')}
+        </button>
+        <button class="btn-ghost adm-agi-stuck-btn" onClick=${handleSkip} disabled=${acting}>
+          ${t('admin.agentIntegration.skipStep')}
+        </button>
+      </div>
+    </div>
+  `;
+}
+
+function getSuggestion(stepId) {
+  if (stepId?.includes('webhook') || stepId?.includes('delivery'))
+    return t('admin.agentIntegration.suggestion.webhook');
+  if (stepId?.includes('platform') || stepId?.includes('detect'))
+    return t('admin.agentIntegration.suggestion.platform');
+  if (stepId?.includes('skill') || stepId?.includes('bundle'))
+    return t('admin.agentIntegration.suggestion.skillBundle');
+  return t('admin.agentIntegration.suggestion.default');
+}
+
+function renderReadinessDistribution(readiness, total) {
+  if (!readiness) return '';
+  const dist = readiness.distribution || {};
+  const levels = ['expert', 'full', 'standard', 'basic'];
+
+  return html`
+    <div class="adm-agi-subsection">
+      <div class="adm-agi-section-title">${t('admin.agentIntegration.readinessDistribution')}</div>
+      ${total === 0
+        ? html`<div class="adm-agi-empty-text">${t('common.noData')}</div>`
+        : html`
+          ${levels.map(level => {
+            const count = dist[level] || 0;
+            const pct = total > 0 ? (count / total * 100) : 0;
+            return html`
+              <div class="adm-agi-readiness-bar">
+                <div class="adm-agi-readiness-level">${t(`agentOnboarding.readiness.${level}`)}</div>
+                <div class="adm-agi-readiness-track">
+                  <div class="adm-agi-readiness-fill" style="width:${pct}%" data-level="${level}"></div>
+                </div>
+                <div class="adm-agi-readiness-count">${count}</div>
+              </div>
+            `;
+          })}
+          <div class="adm-agi-footer">
+            ${t('admin.agentIntegration.totalAgents')}: ${num(total)}
+          </div>
+        `
+      }
+    </div>
+  `;
+}
+
+/* ── F21: Added "Current version" column to skill bundle table ── */
+function renderSkillBundles(bundles, onRegenerate, regenerating, session) {
+  if (!bundles) return '';
+  const entries = Object.entries(bundles);
+
+  const handleNotify = async (platform) => {
+    try {
+      await api.notifyOutdatedAgents(session, platform);
+      window.dispatchEvent(new CustomEvent('aimeat-toast', { detail: { message: t('admin.agentIntegration.notifySuccess') } }));
+    } catch { /* ignore */ }
+  };
+
+  return html`
+    <div class="adm-agi-section">
+      <div class="adm-agi-section-title">${t('admin.agentIntegration.skillBundles')}</div>
+      ${entries.length === 0
+        ? html`<div class="adm-agi-empty-text">${t('common.noData')}</div>`
+        : html`
+          <table class="adm-agi-table">
+            <thead><tr>
+              <th>${t('admin.agentIntegration.platform')}</th>
+              <th>${t('admin.agentIntegration.agentCount')}</th>
+              <th>${t('admin.agentIntegration.currentVersion')}</th>
+              <th>${t('admin.agentIntegration.outdated')}</th>
+              <th></th>
+            </tr></thead>
+            <tbody>
+              ${entries.map(([platform, info]) => html`
+                <tr>
+                  <td>${platform}</td>
+                  <td>${num(info.agents)}</td>
+                  <td class="adm-agi-mono-sm">${info.version || info.currentVersion || '--'}</td>
+                  <td>${info.outdated > 0
+                    ? html`<span class="adm-agi-outdated">${num(info.outdated)}</span>`
+                    : html`<span class="adm-agi-zero">0</span>`
+                  }</td>
+                  <td>${info.outdated > 0 ? html`
+                    <button class="btn-outline adm-agi-notify-btn" onClick=${() => handleNotify(platform)}>
+                      ${t('admin.agentIntegration.notifyOutdated')}
+                    </button>
+                  ` : ''}</td>
+                </tr>
+              `)}
+            </tbody>
+          </table>
+        `
+      }
+      <button class="btn-outline adm-agi-regen-btn" onClick=${onRegenerate} disabled=${regenerating}>
+        ${regenerating ? t('common.loading') : t('admin.agentIntegration.regenerateAll')}
+      </button>
+    </div>
+  `;
+}
+
+/* ── Bundle Templates (Phase C stub) ── */
+function renderBundleTemplates() {
+  const handleComingSoon = () => {
+    window.dispatchEvent(new CustomEvent('aimeat-toast', { detail: { message: t('admin.agentIntegration.comingSoon') } }));
+  };
+
+  return html`
+    <div class="adm-agi-section">
+      <div class="adm-agi-section-title">${t('admin.agentIntegration.bundleTemplates')}</div>
+      <div class="adm-agi-stats">
+        <div class="adm-agi-stat-card">
+          <div class="adm-agi-stat-value">0</div>
+          <div class="adm-agi-stat-label">${t('admin.agentIntegration.customReferences')}</div>
+        </div>
+        <div class="adm-agi-stat-card">
+          <div class="adm-agi-stat-value">0</div>
+          <div class="adm-agi-stat-label">${t('admin.agentIntegration.customScripts')}</div>
+        </div>
+        <div class="adm-agi-stat-card">
+          <div class="adm-agi-stat-value adm-agi-mono-sm">--</div>
+          <div class="adm-agi-stat-label">${t('admin.agentIntegration.lastGenerated')}</div>
+        </div>
+      </div>
+      <div class="adm-agi-btn-row">
+        <button class="btn-outline" onClick=${handleComingSoon}>
+          ${t('admin.agentIntegration.customizeBundle')}
+        </button>
+        <button class="btn-outline" onClick=${handleComingSoon}>
+          ${t('admin.agentIntegration.previewBundle')}
+        </button>
+      </div>
+    </div>
+  `;
+}

package/dist/public/views/admin.js

@@ -50,6 +50,7 @@ import GeneratorDebugTab from './admin/generator-debug-tab.js';
 import CapabilitiesAdminTab from './admin/capabilities-tab.js';
 import AgentTasksAdminTab from './admin/agent-tasks-tab.js';
 import SharingGroupsAdminTab from './admin/sharing-groups-tab.js';
+import AgentIntegrationAdminTab from './admin/agent-integration-tab.js';
 
 // ── Sidebar nav structure ──
 const NAV_GROUPS = [
@@ -68,6 +69,7 @@ const NAV_GROUPS = [
     { id: 'owners',  icon: '\u{1F464}', key: 'dashboard.owners',  component: OwnersTab,  count: 'owners' },
     { id: 'agents',  icon: '\u{1F916}', key: 'dashboard.agents',  component: AgentsTab,  count: 'agents' },
     { id: 'ghii',    icon: '\u{1F511}', key: 'dashboard.ghii',    component: GhiiTab,    count: 'ghii' },
+    { id: 'agent-integration', icon: '\u{1F50C}', key: 'admin.tabs.agentIntegration', component: AgentIntegrationAdminTab },
   ]},
   { key: 'dashboard.navData', items: [
     { id: 'actions',       icon: '\u26A1',     key: 'dashboard.actions',       component: ActionsTab,        count: 'actions' },