aimeat 1.23.3 → 1.24.1

package/dist/locales/en.json

@@ -1,6 +1,52 @@
 {
   "profile.landing.home": "Home",
   "profile.landing.menu": "Menu",
+  "profile.tabs.workflows": "Workflows",
+  "profile.workflows.title": "Workflows",
+  "profile.workflows.desc": "Declared, ordered agent pipelines with per-step health checks — they show whether each step actually produced, not just that it fired.",
+  "profile.workflows.loading": "Loading workflows…",
+  "profile.workflows.empty": "No workflows yet. An agent or the API can define one; it will appear here.",
+  "profile.workflows.trigger.schedule": "schedule",
+  "profile.workflows.trigger.event": "event",
+  "profile.workflows.trigger.manual": "manual",
+  "profile.workflows.stepCount": "{count} steps",
+  "profile.workflows.lastRun": "last run",
+  "profile.workflows.check": "Check",
+  "profile.workflows.run": "Run",
+  "profile.workflows.runStarted": "Run started",
+  "profile.workflows.back": "Back",
+  "profile.workflows.blueprint": "Blueprint",
+  "profile.workflows.after": "after",
+  "profile.workflows.recentRuns": "Recent runs",
+  "profile.workflows.noRuns": "No runs yet.",
+  "profile.workflows.attempt": "attempt",
+  "profile.workflows.health.title": "Per-step health over recent runs (green = produced, red = failed)",
+  "profile.workflows.inspectorDispatched": "{count} inspector task(s) dispatched",
+  "profile.workflows.new": "New",
+  "profile.workflows.edit": "Edit",
+  "profile.workflows.form.newTitle": "New workflow",
+  "profile.workflows.form.editTitle": "Edit workflow",
+  "profile.workflows.form.id": "Id (slug)",
+  "profile.workflows.form.idHint": "Id must be a lowercase slug (a-z, 0-9, hyphens).",
+  "profile.workflows.form.titleField": "Title",
+  "profile.workflows.form.description": "Description",
+  "profile.workflows.form.trigger": "Trigger",
+  "profile.workflows.form.matchKey": "match key (glob)",
+  "profile.workflows.form.matchOffer": "match offer id",
+  "profile.workflows.form.vars": "Variables",
+  "profile.workflows.form.addVar": "var",
+  "profile.workflows.form.steps": "Steps",
+  "profile.workflows.form.addStep": "step",
+  "profile.workflows.form.pickAgent": "agent…",
+  "profile.workflows.form.pickOffer": "offer…",
+  "profile.workflows.form.noCompatibleOffers": "This agent has no workflow-compatible offers (must publish success_signal + required_to_function + deliverable.location).",
+  "profile.workflows.form.noInput": "no input gate",
+  "profile.workflows.form.llmApproved": "Allow the node LLM to evaluate llm signal leaves in this workflow",
+  "profile.workflows.form.cancel": "Cancel",
+  "profile.workflows.form.save": "Save",
+  "profile.workflows.form.saved": "Workflow saved",
+  "profile.workflows.cancelRun": "Cancel run",
+  "profile.workflows.cancelled": "Run cancelled",
   "profile.tabs.scheduler": "Scheduler",
   "profile.agents.detail.tabs.schedules": "Schedules",
   "profile.scheduler.title": "Scheduler",
@@ -5853,6 +5899,9 @@
     "moreActions": "More actions",
     "policyLabel": "Join policy",
     "tabWorkspaces": "Workspaces",
+    "structureOverviewOrg": "Organism structure overview",
+    "structureOverviewWs": "Workspace structure overview",
+    "structEmpty": "No structure to show yet.",
     "tabMembers": "Members",
     "tabAgents": "Agents",
     "tabBoard": "Board",
@@ -6358,7 +6407,10 @@
       "complete_test_task": "Agent executes and completes the test task",
       "publish_commands": "agents.{name}.commands memory has a non-empty array of { name, description, category }",
       "publish_config": "At least one agents.config.{name}.* memory entry exists describing this runtime",
-      "declare_services": "Agent declares offered services (optional)"
+      "declare_services": "Agent declares offered services (optional)",
+      "declare_offerings": "Agent publishes at least one offer (id + title + ask) to agents.{name}.offers so the owner can find what it does (optional)",
+      "make_workflow_compatible": "At least one offer declares success_signal + required_to_function + deliverable.location, so it can be a step in an Agent Workflow (optional)",
+      "price_offer": "At least one offer is sellable cross-owner: price + visibility public + a callable binding (optional)"
     },
     "errors": {
       "accessDenied": "Access denied",

package/dist/locales/fi.json

@@ -1,6 +1,52 @@
 {
   "profile.landing.home": "Etusivu",
   "profile.landing.menu": "Valikko",
+  "profile.tabs.workflows": "Työnkulut",
+  "profile.workflows.title": "Työnkulut",
+  "profile.workflows.desc": "Määritellyt, järjestetyt agenttiketjut askelkohtaisilla terveystarkistuksilla — ne näyttävät tuottiko jokainen askel oikeasti tuloksen, ei vain että se käynnistyi.",
+  "profile.workflows.loading": "Ladataan työnkulkuja…",
+  "profile.workflows.empty": "Ei työnkulkuja vielä. Agentti tai API voi määritellä sellaisen; se ilmestyy tähän.",
+  "profile.workflows.trigger.schedule": "ajastus",
+  "profile.workflows.trigger.event": "tapahtuma",
+  "profile.workflows.trigger.manual": "manuaalinen",
+  "profile.workflows.stepCount": "{count} askelta",
+  "profile.workflows.lastRun": "viimeisin ajo",
+  "profile.workflows.check": "Tarkista",
+  "profile.workflows.run": "Aja",
+  "profile.workflows.runStarted": "Ajo käynnistetty",
+  "profile.workflows.back": "Takaisin",
+  "profile.workflows.blueprint": "Rakennekaavio",
+  "profile.workflows.after": "jälkeen",
+  "profile.workflows.recentRuns": "Viimeisimmät ajot",
+  "profile.workflows.noRuns": "Ei ajoja vielä.",
+  "profile.workflows.attempt": "yritys",
+  "profile.workflows.health.title": "Askelkohtainen terveys viime ajoista (vihreä = tuotti, punainen = epäonnistui)",
+  "profile.workflows.inspectorDispatched": "{count} tarkastustaskia lähetetty",
+  "profile.workflows.new": "Uusi",
+  "profile.workflows.edit": "Muokkaa",
+  "profile.workflows.form.newTitle": "Uusi työnkulku",
+  "profile.workflows.form.editTitle": "Muokkaa työnkulkua",
+  "profile.workflows.form.id": "Tunnus (slug)",
+  "profile.workflows.form.idHint": "Tunnuksen on oltava pienaakkos-slug (a-z, 0-9, väliviivat).",
+  "profile.workflows.form.titleField": "Otsikko",
+  "profile.workflows.form.description": "Kuvaus",
+  "profile.workflows.form.trigger": "Liipaisin",
+  "profile.workflows.form.matchKey": "osuma-avain (glob)",
+  "profile.workflows.form.matchOffer": "osuma-offer-id",
+  "profile.workflows.form.vars": "Muuttujat",
+  "profile.workflows.form.addVar": "muuttuja",
+  "profile.workflows.form.steps": "Askeleet",
+  "profile.workflows.form.addStep": "askel",
+  "profile.workflows.form.pickAgent": "agentti…",
+  "profile.workflows.form.pickOffer": "offer…",
+  "profile.workflows.form.noCompatibleOffers": "Tällä agentilla ei ole työnkulku-yhteensopivia offereita (täytyy julkaista success_signal + required_to_function + deliverable.location).",
+  "profile.workflows.form.noInput": "ei syöteporttia",
+  "profile.workflows.form.llmApproved": "Salli node-LLM:n arvioida llm-signaalilehdet tässä työnkulussa",
+  "profile.workflows.form.cancel": "Peruuta",
+  "profile.workflows.form.save": "Tallenna",
+  "profile.workflows.form.saved": "Työnkulku tallennettu",
+  "profile.workflows.cancelRun": "Keskeytä ajo",
+  "profile.workflows.cancelled": "Ajo keskeytetty",
   "profile.tabs.scheduler": "Ajastin",
   "profile.agents.detail.tabs.schedules": "Ajastukset",
   "profile.scheduler.title": "Ajastin",
@@ -5853,6 +5899,9 @@
     "moreActions": "Lisätoiminnot",
     "policyLabel": "Liittymiskäytäntö",
     "tabWorkspaces": "Työtilat",
+    "structureOverviewOrg": "Organismin rakenteen yleiskuva",
+    "structureOverviewWs": "Työtilan rakenteen yleiskuva",
+    "structEmpty": "Ei vielä rakennetta näytettäväksi.",
     "tabMembers": "Jäsenet",
     "tabAgents": "Agentit",
     "tabBoard": "Taulu",
@@ -6358,7 +6407,10 @@
       "complete_test_task": "Agentti suorittaa ja viimeistelee testitehtävän",
       "publish_commands": "agents.{name}.commands -muistissa on epätyhjä { name, description, category } -taulu",
       "publish_config": "Vähintään yksi agents.config.{name}.* -muistitietue kuvaa tätä runtimea",
-      "declare_services": "Agentti ilmoittaa tarjoamansa palvelut (valinnainen)"
+      "declare_services": "Agentti ilmoittaa tarjoamansa palvelut (valinnainen)",
+      "declare_offerings": "Agentti julkaisee vähintään yhden tarjouksen (id + title + ask) avaimeen agents.{name}.offers, jotta omistaja löytää mitä se tekee (valinnainen)",
+      "make_workflow_compatible": "Vähintään yksi tarjous määrittää success_signal + required_to_function + deliverable.location, jolloin se voi olla työnkulun vaihe (valinnainen)",
+      "price_offer": "Vähintään yksi tarjous on myytävissä omistajien välillä: price + visibility public + kutsuttava sidonta (valinnainen)"
     },
     "errors": {
       "accessDenied": "Pääsy estetty",

package/dist/public/css/views/profile.css

@@ -2492,6 +2492,27 @@
 .pj-org-tab-count { color: var(--muted); font-size: 0.75rem; margin-left: 0.3rem; }
 .pj-org-boardrow { display: flex; align-items: center; gap: 0.5rem; flex-wrap: wrap; }
 
+/* ── OKF-style structure overview (collapsible Markdown map of an organism / workspace) ── */
+.pj-struct-overview { margin: 0.4rem 0 0.8rem; }
+.pj-struct-toggle { display: inline-flex; align-items: center; gap: 0.4rem; background: none; border: none; padding: 0.3rem 0; font-size: 0.85rem; color: var(--text-dim); cursor: pointer; }
+.pj-struct-toggle:hover { color: var(--text); }
+.pj-struct-caret { color: var(--muted); font-size: 0.8rem; width: 0.8rem; }
+.pj-struct-body { margin-top: 0.4rem; max-height: 32rem; overflow: auto; padding: 0.75rem 0.9rem; }
+/* Compact, on-theme typography so the rendered map reads as part of the dashboard, not a raw doc. */
+.pj-struct-body .md-body { font-size: 0.85rem; color: var(--text); line-height: 1.5; }
+.pj-struct-body .md-body > :first-child { margin-top: 0; }
+.pj-struct-body .md-body h1 { font-size: 1rem; font-weight: 700; margin: 0 0 0.3rem; color: var(--text); }
+.pj-struct-body .md-body h2 { font-size: 0.92rem; font-weight: 700; margin: 0.95rem 0 0.35rem; padding-top: 0.55rem; border-top: 1px solid var(--border); color: var(--text); }
+.pj-struct-body .md-body h3 { font-size: 0.83rem; font-weight: 600; margin: 0.55rem 0 0.2rem; color: var(--text-dim); text-transform: none; }
+.pj-struct-body .md-body p { margin: 0.2rem 0; }
+.pj-struct-body .md-body blockquote { margin: 0.2rem 0; padding: 0 0 0 0.6rem; border-left: 2px solid var(--border); color: var(--muted); font-size: 0.8rem; }
+.pj-struct-body .md-body blockquote p { margin: 0.1rem 0; }
+.pj-struct-body .md-body ul { margin: 0.2rem 0 0.4rem; padding-left: 1.15rem; }
+.pj-struct-body .md-body li { margin: 0.12rem 0; }
+.pj-struct-body .md-body code { background: var(--bg-dim); border: 1px solid var(--border); border-radius: 4px; padding: 0.02rem 0.32rem; font-size: 0.78rem; }
+.pj-struct-body .md-body strong { font-weight: 600; }
+.pj-struct-body .md-body em { color: var(--muted); font-style: normal; }
+
 /* ── Workspace renew (phase 2): header actions, review banner, add-space tab ── */
 .pj-ws-head-actions { margin-left: auto; display: flex; gap: 0.4rem; align-items: center; }
 .pj-ws-banner { display: flex; align-items: center; gap: 0.75rem; flex-wrap: wrap; border: 1px solid var(--border); border-left: 3px solid var(--warn, var(--accent)); border-radius: 10px; background: var(--card); padding: 0.55rem 0.75rem; margin: 0.6rem 0 0.2rem; }

package/dist/public/css/views/workflows.css

@@ -0,0 +1,116 @@
+/**
+ * @file workflows.css
+ * @description Styles for Profile › Workflows (workflows-tab.js): the list of workflows with a
+ *   health sparkline, the blueprint graph + recent runs detail, and the single-run per-step
+ *   timeline. Prefix: wf-. Theme-token driven (no hardcoded colors) so it flips with dark/light.
+ * @version-history
+ *   v1.0.0 -- 2026-06-13 -- Phase 9: initial workflows tab styles.
+ */
+
+.wf-tab { display: flex; flex-direction: column; gap: 1.1rem; }
+.wf-head { display: flex; align-items: flex-start; justify-content: space-between; gap: 1rem; }
+.wf-loading, .wf-empty { color: var(--text-dim); padding: 0.75rem 0; font-size: 0.92rem; }
+.wf-error {
+  background: var(--danger-bg); color: var(--danger-fg);
+  border: 1px solid var(--danger-border, var(--border)); border-radius: var(--radius-sm); padding: 0.6rem 0.85rem;
+}
+.wf-muted { color: var(--text-dim); font-size: 0.82rem; }
+.wf-section-title { font-size: 1rem; font-weight: 700; color: var(--text); margin: 0.5rem 0 0.1rem; }
+
+/* ── badges ── */
+.wf-badge {
+  display: inline-block; padding: 0.1rem 0.5rem; border-radius: var(--radius-full, 999px);
+  font-size: 0.72rem; font-weight: 700; line-height: 1.5;
+}
+.wf-badge--ok { background: var(--success-bg); color: var(--success-fg); }
+.wf-badge--err { background: var(--danger-bg); color: var(--danger-fg); }
+.wf-badge--run { background: var(--info-bg); color: var(--info-fg); }
+.wf-badge--muted { background: var(--bg-dim); color: var(--text-dim); }
+
+/* ── list ── */
+.wf-card-list { display: flex; flex-direction: column; gap: 0.75rem; }
+.wf-card {
+  display: flex; align-items: center; justify-content: space-between; gap: 1rem;
+  background: var(--card); border: 1px solid var(--border); border-radius: var(--radius); padding: 0.85rem 1rem;
+}
+.wf-card-main { flex: 1; cursor: pointer; display: flex; flex-direction: column; gap: 0.25rem; }
+.wf-card-title { font-weight: 700; color: var(--text); display: flex; align-items: center; gap: 0.5rem; }
+.wf-card-meta { font-size: 0.82rem; color: var(--text-dim); }
+.wf-card-actions { display: flex; gap: 0.4rem; white-space: nowrap; }
+
+/* ── sparkline ── */
+.wf-spark { display: inline-flex; gap: 2px; margin-top: 0.2rem; align-items: flex-end; }
+.wf-spark-bar { width: 7px; height: 14px; border-radius: 2px; display: inline-block; }
+.wf-spark-bar--ok { background: var(--success-fg); }
+.wf-spark-bar--err { background: var(--danger-fg); }
+.wf-spark-bar--none { background: var(--bg-dim); }
+
+/* ── detail ── */
+.wf-detail-head { display: flex; align-items: center; gap: 0.75rem; flex-wrap: wrap; }
+.wf-detail-titlebox { flex: 1; display: flex; flex-direction: column; gap: 0.1rem; min-width: 0; }
+.wf-detail-title { font-size: 1.1rem; font-weight: 700; color: var(--text); }
+.wf-detail-sub { font-size: 0.8rem; color: var(--text-dim); }
+.wf-detail-sub code { font-family: var(--font-mono, monospace); }
+.wf-detail-desc { color: var(--text-dim); font-size: 0.9rem; margin: -0.3rem 0 0.3rem; }
+.wf-detail-actions { display: flex; gap: 0.4rem; }
+.wf-node-desc { font-weight: 400; color: var(--text-dim); font-size: 0.85rem; }
+
+.wf-graph { display: flex; flex-direction: column; gap: 0.5rem; }
+.wf-node {
+  background: var(--card); border: 1px solid var(--border); border-radius: var(--radius-sm);
+  padding: 0.6rem 0.8rem; display: flex; flex-direction: column; gap: 0.15rem;
+}
+.wf-node-id { font-weight: 700; color: var(--text); }
+.wf-node-agent { font-size: 0.82rem; color: var(--text-dim); }
+.wf-node-io { font-size: 0.78rem; color: var(--text-dim); font-family: var(--font-mono, monospace); }
+.wf-node-dep { font-size: 0.74rem; color: var(--accent); }
+
+.wf-table { width: 100%; border-collapse: collapse; font-size: 0.9rem; }
+.wf-table td { padding: 0.5rem 0.6rem; border-bottom: 1px solid var(--border); color: var(--text); }
+.wf-run-row { cursor: pointer; }
+.wf-run-row:hover { background: var(--bg-dim); }
+
+/* ── run timeline ── */
+.wf-steps { display: flex; flex-direction: column; gap: 0.5rem; }
+.wf-step {
+  background: var(--card); border: 1px solid var(--border); border-radius: var(--radius-sm); padding: 0.55rem 0.8rem;
+}
+.wf-step-row { display: flex; align-items: center; gap: 0.6rem; }
+.wf-step-id { font-weight: 600; color: var(--text); }
+.wf-observed {
+  margin: 0.4rem 0 0; padding: 0.5rem 0.65rem; background: var(--bg-dim); border-radius: var(--radius-sm);
+  font-size: 0.76rem; color: var(--text-dim); overflow-x: auto; white-space: pre-wrap;
+}
+.wf-inspections {
+  margin-top: 0.5rem; padding: 0.5rem 0.7rem; background: var(--warn-bg); color: var(--warn-fg);
+  border-radius: var(--radius-sm); font-size: 0.82rem;
+}
+
+/* ── create/edit form ── */
+.wf-form { display: flex; flex-direction: column; gap: 0.8rem; }
+.wf-field { display: flex; flex-direction: column; gap: 0.25rem; }
+.wf-field > span { font-size: 0.82rem; font-weight: 600; color: var(--text-dim); }
+.wf-field input[type="text"], .wf-field input[type="number"], .wf-field select,
+.wf-field-row input, .wf-field-row select {
+  background: var(--bg-input, var(--bg-dim)); color: var(--text);
+  border: 1px solid var(--border); border-radius: var(--radius-sm);
+  padding: 0.4rem 0.55rem; font: inherit;
+}
+.wf-field-row { display: flex; gap: 0.5rem; align-items: center; flex-wrap: wrap; }
+.wf-field-row > input, .wf-field-row > select { flex: 1; min-width: 8rem; }
+.wf-form-section {
+  border: 1px solid var(--border); border-radius: var(--radius-sm); padding: 0.7rem 0.85rem;
+  display: flex; flex-direction: column; gap: 0.55rem;
+}
+.wf-form-section-head { display: flex; justify-content: space-between; align-items: center; font-weight: 700; color: var(--text); }
+.wf-step-edit {
+  border-left: 2px solid var(--accent-soft, var(--border)); padding-left: 0.7rem;
+  display: flex; flex-direction: column; gap: 0.4rem;
+}
+.wf-step-opts { font-size: 0.82rem; color: var(--text-dim); }
+.wf-step-after { display: flex; flex-wrap: wrap; gap: 0.6rem; align-items: center; font-size: 0.82rem; }
+.wf-inline { display: inline-flex; align-items: center; gap: 0.3rem; color: var(--text); }
+.wf-inline input[type="number"] { width: 4.5rem; background: var(--bg-input, var(--bg-dim)); color: var(--text); border: 1px solid var(--border); border-radius: var(--radius-sm); padding: 0.2rem 0.4rem; }
+.wf-llm-toggle { margin-top: 0.2rem; font-size: 0.9rem; }
+.wf-form-actions { display: flex; justify-content: flex-end; gap: 0.5rem; margin-top: 0.4rem; }
+.wf-err-list { margin: 0; padding-left: 1.1rem; }

package/dist/public/js/services/organisms.js

@@ -491,6 +491,24 @@ export async function getWorkspace(orgId, wsId) {
   return resp?.data || null;
 }
 
+/** OKF-style STRUCTURE OVERVIEW (Markdown) of the whole organism — every workspace's space
+ *  breakdown + totals, deterministic, size-bounded. Returns '' on failure (caller shows a notice). */
+export async function getOrganismOverview(orgId) {
+  try {
+    const r = await apiGet(`/v1/organisms/${encodeURIComponent(orgId)}/overview`);
+    return r?.data?.markdown || '';
+  } catch { return ''; }
+}
+
+/** OKF-style STRUCTURE OVERVIEW (Markdown) of ONE workspace — per space the most-recent entries
+ *  (ids + titles) and totals. Returns '' on failure. */
+export async function getWorkspaceOverview(orgId, wsId) {
+  try {
+    const r = await apiGet(`/v1/organisms/${encodeURIComponent(orgId)}/workspace/overview?ws=${encodeURIComponent(wsId)}`);
+    return r?.data?.markdown || '';
+  } catch { return ''; }
+}
+
 /** Overwrite a workspace's manifest (e.g. edited name/summary/policy from Settings). */
 export async function saveManifest(orgId, wsId, manifest) {
   return apiPost('/v1/memory', { key: `${wsRoot(orgId, wsId)}.meta.manifest`, value: manifest, visibility: 'private' });

package/dist/public/js/services/workflows.js

@@ -0,0 +1,62 @@
+/**
+ * @file workflows.js
+ * @description Frontend API service for Agent Workflows (Profile › Workflows tab). Wraps the
+ *   /v1/workflows endpoints (list / get / blueprint / runs / run / health). All functions return
+ *   the AIMEAT envelope; callers read `res.data`.
+ * @usage import { listWorkflows, getBlueprint, runWorkflow } from '/js/services/workflows.js';
+ * @version-history
+ *   v1.0.0 -- 2026-06-13 -- Phase 9: initial workflows service for the profile tab.
+ */
+import { apiGet, apiPost, apiPut, apiDelete } from '/js/api.js';
+
+/** Create/update a workflow definition (PUT /v1/workflows/:id). Returns the envelope. */
+export async function putWorkflow(id, def) {
+  return apiPut(`/v1/workflows/${encodeURIComponent(id)}`, def);
+}
+
+export async function deleteWorkflow(id) {
+  return apiDelete(`/v1/workflows/${encodeURIComponent(id)}`);
+}
+
+/** Read one agent's published offers (to pick a workflow-compatible offer in the form). */
+export async function getAgentOffers(agentName) {
+  return apiGet(`/v1/agents/${encodeURIComponent(agentName)}/offers`);
+}
+
+/** List the owner's workflow definitions: { workflows, count }. */
+export async function listWorkflows() {
+  return apiGet('/v1/workflows');
+}
+
+export async function getWorkflow(id) {
+  return apiGet(`/v1/workflows/${encodeURIComponent(id)}`);
+}
+
+/** Derived structural graph: { workflowId, nodes, edges }. */
+export async function getBlueprint(id) {
+  return apiGet(`/v1/workflows/${encodeURIComponent(id)}/blueprint`);
+}
+
+/** Run-health trend over recent runs: { sample, lastStatus, steps:[{stepId,green,red}] , … }. */
+export async function getHealth(id) {
+  return apiGet(`/v1/workflows/${encodeURIComponent(id)}/health`);
+}
+
+/** List runs (newest first): { runs, count }. */
+export async function listRuns(id) {
+  return apiGet(`/v1/workflows/${encodeURIComponent(id)}/runs`);
+}
+
+export async function getRun(id, runId) {
+  return apiGet(`/v1/workflows/${encodeURIComponent(id)}/runs/${encodeURIComponent(runId)}`);
+}
+
+/** Start a run. mode: 'signals-only' | 'full'. Returns { runId, mode }. */
+export async function runWorkflow(id, mode, vars) {
+  return apiPost(`/v1/workflows/${encodeURIComponent(id)}/run`, { mode, ...(vars ? { vars } : {}) });
+}
+
+/** Cancel an in-flight run (stuck / gone wrong). */
+export async function cancelRun(id, runId) {
+  return apiPost(`/v1/workflows/${encodeURIComponent(id)}/runs/${encodeURIComponent(runId)}/cancel`, {});
+}

package/dist/public/llms-template.txt

@@ -385,6 +385,13 @@ for completeness but are NOT needed for typical app building:
 - Packages (versioned bundles), Knowledge packages
 - Federation (node peering, cross-node routing)
 - Agent collaboration (shared memory, organisms)
+- Agent Workflows: declared, ordered agent pipelines with per-step input/output signals checked
+  after each step, so the owner sees whether each step PRODUCED (not just fired). One trigger
+  (schedule / manual / event) drives the chain; each step names an agent + an offer and inherits
+  that offer's signals + deliverable location. Connected agents use aimeat_workflow_save / _get /
+  _run (signals-only = check vs memory, no dispatch; full = execute). Stored in owner memory
+  (workflows.def.* / workflows.run.*); API under /v1/workflows. Plan:
+  docs/plans/2026-06-13-agent-workflows-node-plan.md.
 - Organism workspaces: an organism can hold manifest-driven workspaces of markdown documents
   (a wiki) and schema-locked record lists, with a draft -> publish -> version flow. Connected
   agents use the aimeat_workspace_* MCP tools (list / read / write / publish / object_delete /

package/dist/public/spa.html

@@ -84,6 +84,7 @@
   <link rel="stylesheet" href="/css/views/capabilities.css">
   <link rel="stylesheet" href="/css/views/agents-detail.css">
   <link rel="stylesheet" href="/css/views/scheduler.css">
+  <link rel="stylesheet" href="/css/views/workflows.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">
@@ -199,7 +200,8 @@
       "/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",
-      "/js/services/schedules.js": "/js/services/schedules.js"
+      "/js/services/schedules.js": "/js/services/schedules.js",
+      "/js/services/workflows.js": "/js/services/workflows.js"
     }
   }
   </script>

package/dist/public/views/profile/landing-page.js

@@ -755,6 +755,7 @@ const SIDEBAR_GROUPS = [
     { id: 'agents', icon: '\u{1F916}', labelKey: 'profile.tabs.agents' },
     { id: 'offers', icon: '\u{1F9F0}', labelKey: 'profile.tabs.offers' },
     { id: 'scheduler', icon: '⏰', labelKey: 'profile.tabs.scheduler' },
+    { id: 'workflows', icon: '\u{1F500}', labelKey: 'profile.tabs.workflows' },
     { id: 'actions', icon: '\u{1F6E0}️', labelKey: 'profile.tabs.services' },
     { id: 'mcp', icon: '\u{1F517}', labelKey: 'profile.tabs.mcp' },
   ] },

package/dist/public/views/profile/organisms-tab.js

@@ -148,6 +148,11 @@
  *     auto-activates; §7c) — the agent joins/provisions its own spaces and the task completion is
  *     the ack. An agent already working in THIS workspace (per the participants data) shows a
  *     "✓ active here" badge instead of Adopt. Convention agreed with the crewaimeat side 2026-06-10.
+ *   v1.29.0 — 2026-06-13 — OKF-style structure overview: a collapsible <${'StructureOverview'}> panel in
+ *     OrganismHome (📐 Organism structure overview — every workspace's space breakdown + totals) and in
+ *     Workspace (📐 Workspace structure overview — per-space recent ids + titles). Lazy-loads a
+ *     deterministic Markdown map from the server (orgService.getOrganismOverview / getWorkspaceOverview)
+ *     and renders it via the safe Markdown component. Collapsed by default (no cost until opened).
  *   v1.28.0 — 2026-06-12 — Overview landing tab: the whole workspace on one vertical scroll — a
  *     "what happened here" strip (last 8 activity events, humanized + clickable) above every
  *     manifest space stacked in order (records: compact rows max 5 + "Show all N →"; documents:
@@ -237,6 +242,46 @@ function KebabMenu({ items, label, trigger, btnClass }) {
 
 /** Tag chips + inline input — Enter/comma adds, × or Backspace-on-empty removes, blur commits.
  *  Shows immediately how the value parses (vs. a raw "comma separated" text field). */
+/** Collapsible OKF-style structure-overview panel. A button that, on first expand, lazy-loads a
+ *  deterministic Markdown structure map (server projection — never persisted) and renders it via the
+ *  safe Markdown component. Used at organism level (every workspace's space breakdown) and workspace
+ *  level (per-space recent ids + titles). Collapsed by default so it costs nothing until asked for. */
+function StructureOverview({ load, label }) {
+  const [open, setOpen] = useState(false);
+  const [md, setMd] = useState(null);   // null = not loaded yet; '' = loaded but empty/failed
+  const [busy, setBusy] = useState(false);
+  const toggle = async () => {
+    const next = !open;
+    setOpen(next);
+    if (next && md === null && !busy) {
+      setBusy(true);
+      // For the human view, strip the OKF YAML frontmatter (machine metadata — kept in the raw
+      // server/MCP output) AND the leading "# … — structure overview" H1 (the panel toggle already
+      // names it; the page header already shows the org/workspace name). The body starts at the
+      // description / totals line.
+      try {
+        const raw = (await load()) || '';
+        setMd(raw.replace(/^---\n[\s\S]*?\n---\n+/, '').replace(/^#\s+.*\n+/, ''));
+      } finally { setBusy(false); }
+    }
+  };
+  return html`
+    <div class="pj-struct-overview">
+      <button class="pj-struct-toggle" aria-expanded=${open} onClick=${toggle}>
+        <span class="pj-struct-caret">${open ? '▾' : '▸'}</span>
+        <span>${'📐 '}${label}</span>
+      </button>
+      ${open ? html`
+        <div class="pj-struct-body card-detail">
+          ${busy
+            ? html`<${Spinner} text=${t('organisms.loading') || 'Loading...'} />`
+            : (md
+              ? html`<${Markdown} text=${md} />`
+              : html`<div class="section-desc">${t('organisms.structEmpty') || 'No structure to show yet.'}</div>`)}
+        </div>` : null}
+    </div>`;
+}
+
 function TagInput({ tags, onChange, placeholder }) {
   const [val, setVal] = useState('');
   const add = () => { const v = val.trim().replace(/,+$/, ''); if (v && !tags.includes(v)) onChange([...tags, v]); setVal(''); };
@@ -1413,6 +1458,9 @@ function OrganismHome({ org, ghii, showToast, initialSettings, onOpenWs, onBack,
         </div>
       </div>
 
+      <${StructureOverview} label=${t('organisms.structureOverviewOrg') || 'Organism structure overview'}
+        load=${() => orgService.getOrganismOverview(org.id)} />
+
       <div class="pj-org-tabs" role="tablist">
         ${tabs.map(tb => html`
           <button class="pj-org-tab ${activeHomeTab === tb.id ? 'active' : ''}" role="tab" aria-selected=${activeHomeTab === tb.id} key=${tb.id}
@@ -2951,6 +2999,9 @@ function Workspace({ org, wsId, showToast, onBack, onBackToList }) {
       </div>
       ${ws.manifest?.summary ? html`<div class="section-desc">${(ws.manifest.summary)}</div>` : null}
 
+      <${StructureOverview} label=${t('organisms.structureOverviewWs') || 'Workspace structure overview'}
+        load=${() => orgService.getWorkspaceOverview(orgId, wsId)} />
+
       ${approvals.length > 0 && activeTab !== 'review' ? html`
         <div class="pj-ws-banner" role="status">
           <span class="pj-ws-banner-text">