aimeat 1.23.3 → 1.24.0

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

@@ -0,0 +1,244 @@
+/**
+ * @file workflows-tab.js
+ * @description Profile › Workflows — the owner-facing surface for Agent Workflows (declared, ordered
+ *   agent pipelines with per-step input/output signals). Three views: a list of workflows with a
+ *   health sparkline; a detail view showing the derived blueprint (the "whole workflow" graph) + the
+ *   recent runs; and a single-run view with the per-step timeline (state + expected-vs-observed).
+ *   Run-now offers a signals-only health check or a full live run. Reads the /v1/workflows API; the
+ *   deterministic engine is node-owned. See docs/plans/2026-06-13-agent-workflows-node-plan.md §12.
+ * @structure WorkflowsTab (default) — view state machine (list | detail | run)
+ * @usage Registered in profile.js TABS as { id:'workflows', component: WorkflowsTab }.
+ * @version-history
+ *   v1.0.0 -- 2026-06-13 -- Phase 9: list + blueprint + runs + run-now + health.
+ */
+import { h } from 'preact';
+import { useState, useEffect, useRef, useCallback } from 'preact/hooks';
+import htm from 'htm';
+import { t } from '/js/i18n.js';
+import { timeAgo } from '/js/utils.js';
+import { listWorkflows, getWorkflow, getBlueprint, getHealth, listRuns, getRun, runWorkflow } from '/js/services/workflows.js';
+import WorkflowForm from './workflows-form.js';
+
+const html = htm.bind(h);
+
+/** Pick a display string from a localized value (string | { locale: text }). */
+function loc(s) {
+  if (!s) return '';
+  if (typeof s === 'string') return s;
+  return s.en_US || s.fi_FI || Object.values(s)[0] || '';
+}
+
+function triggerSummary(trigger) {
+  if (!trigger) return '';
+  if (trigger.kind === 'schedule') return `${t('profile.workflows.trigger.schedule')} · ${trigger.cron}${trigger.timezone ? ` (${trigger.timezone})` : ''}`;
+  if (trigger.kind === 'event') return `${t('profile.workflows.trigger.event')} · ${trigger.on}`;
+  return t('profile.workflows.trigger.manual');
+}
+
+/** Map a run/step status to a badge CSS modifier. */
+function statusClass(status) {
+  if (status === 'done' || status === 'green') return 'wf-badge--ok';
+  if (status === 'partial' || status === 'red' || (typeof status === 'string' && status.endsWith('-red')) || status === 'timed-out') return 'wf-badge--err';
+  if (status === 'skipped') return 'wf-badge--muted';
+  return 'wf-badge--run';
+}
+
+function StatusBadge({ status }) {
+  if (!status) return html`<span class="wf-muted">—</span>`;
+  return html`<span class="wf-badge ${statusClass(status)}">${status}</span>`;
+}
+
+/** A tiny sparkline of the last-N run states for one step (green/red bars). */
+function Sparkline({ steps }) {
+  if (!steps || steps.length === 0) return html`<span class="wf-muted">—</span>`;
+  return html`<span class="wf-spark" title=${t('profile.workflows.health.title')}>
+    ${steps.map(s => {
+      const total = s.green + s.red;
+      const cls = total === 0 ? 'wf-spark-bar--none' : s.red > 0 ? 'wf-spark-bar--err' : 'wf-spark-bar--ok';
+      return html`<span class="wf-spark-bar ${cls}" title=${`${s.stepId}: ${s.green}✓ / ${s.red}✗`}></span>`;
+    })}
+  </span>`;
+}
+
+export default function WorkflowsTab({ showToast }) {
+  // view: { name:'list' } | { name:'detail', id } | { name:'run', id, runId }
+  const [view, setView] = useState({ name: 'list' });
+  const [items, setItems] = useState([]); // [{ def, health }]
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+
+  const loadList = useCallback(async () => {
+    try {
+      const res = await listWorkflows();
+      const defs = res?.data?.workflows || [];
+      const withHealth = await Promise.all(defs.map(async (def) => {
+        const hr = await getHealth(def.id).catch(() => null);
+        return { def, health: hr?.data || null };
+      }));
+      setItems(withHealth);
+      setError(null);
+    } catch (e) {
+      setError(e.message || 'Failed to load workflows');
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  const loadRef = useRef(loadList);
+  loadRef.current = loadList;
+  useEffect(() => {
+    loadList();
+    const handler = () => { if (view.name === 'list') loadRef.current(); };
+    window.addEventListener('aimeat-live-update', handler);
+    return () => window.removeEventListener('aimeat-live-update', handler);
+  }, [loadList, view.name]);
+
+  const doRun = async (id, mode) => {
+    try {
+      const res = await runWorkflow(id, mode);
+      const runId = res?.data?.runId;
+      showToast?.(t('profile.workflows.runStarted'), 'success');
+      if (runId) setView({ name: 'run', id, runId });
+      else loadList();
+    } catch (e) {
+      showToast?.(e.message || 'Run failed', 'error');
+    }
+  };
+
+  if (loading) return html`<div class="wf-loading">${t('profile.workflows.loading')}</div>`;
+  if (view.name === 'create') return html`<${WorkflowForm} existing=${null} showToast=${showToast}
+    onCancel=${() => setView({ name: 'list' })} onSaved=${(id) => { setView({ name: 'detail', id }); }} />`;
+  if (view.name === 'edit') return html`<${EditFormView} id=${view.id} showToast=${showToast}
+    onCancel=${() => setView({ name: 'detail', id: view.id })} onSaved=${(id) => setView({ name: 'detail', id })} />`;
+  if (view.name === 'detail') return html`<${DetailView} id=${view.id} onBack=${() => { setView({ name: 'list' }); loadList(); }} onOpenRun=${(runId) => setView({ name: 'run', id: view.id, runId })} onRun=${doRun} onEdit=${() => setView({ name: 'edit', id: view.id })} />`;
+  if (view.name === 'run') return html`<${RunView} id=${view.id} runId=${view.runId} onBack=${() => setView({ name: 'detail', id: view.id })} />`;
+
+  // ── list ──
+  return html`
+    <div class="wf-tab">
+      <div class="wf-head">
+        <div>
+          <div class="section-title">${t('profile.workflows.title')}</div>
+          <div class="section-desc">${t('profile.workflows.desc')}</div>
+        </div>
+        <button class="btn-primary" onClick=${() => setView({ name: 'create' })}>+ ${t('profile.workflows.new')}</button>
+      </div>
+      ${error && html`<div class="wf-error">${error}</div>`}
+      ${items.length === 0
+        ? html`<div class="wf-empty">${t('profile.workflows.empty')}</div>`
+        : html`<div class="wf-card-list">
+            ${items.map(({ def, health }) => html`
+              <div class="wf-card" key=${def.id}>
+                <div class="wf-card-main" onClick=${() => setView({ name: 'detail', id: def.id })}>
+                  <div class="wf-card-title">
+                    ${loc(def.title) || def.id}
+                    <${StatusBadge} status=${health?.lastStatus} />
+                  </div>
+                  <div class="wf-card-meta">${triggerSummary(def.trigger)}</div>
+                  <div class="wf-card-meta">
+                    ${t('profile.workflows.stepCount', { count: def.steps?.length || 0 })}
+                    ${health?.lastRunAt ? html` · ${t('profile.workflows.lastRun')} ${timeAgo(health.lastRunAt)}` : ''}
+                  </div>
+                  <${Sparkline} steps=${health?.steps} />
+                </div>
+                <div class="wf-card-actions">
+                  <button class="btn-outline" onClick=${() => doRun(def.id, 'signals-only')}>${t('profile.workflows.check')}</button>
+                  <button class="btn-primary" onClick=${() => doRun(def.id, 'full')}>${t('profile.workflows.run')}</button>
+                </div>
+              </div>`)}
+          </div>`}
+    </div>`;
+}
+
+// ── Detail: blueprint + recent runs ─────────────────────────────────────────────
+function EditFormView({ id, onCancel, onSaved, showToast }) {
+  const [def, setDef] = useState(null);
+  const [err, setErr] = useState(null);
+  useEffect(() => { getWorkflow(id).then(r => setDef(r?.data || null)).catch(e => setErr(e.message)); }, [id]);
+  if (err) return html`<div class="wf-tab"><div class="wf-error">${err}</div></div>`;
+  if (!def) return html`<div class="wf-loading">${t('profile.workflows.loading')}</div>`;
+  return html`<${WorkflowForm} existing=${def} showToast=${showToast} onCancel=${onCancel} onSaved=${onSaved} />`;
+}
+
+function DetailView({ id, onBack, onOpenRun, onRun, onEdit }) {
+  const [blueprint, setBlueprint] = useState(null);
+  const [runs, setRuns] = useState([]);
+  const [err, setErr] = useState(null);
+
+  const load = useCallback(async () => {
+    const [bp, rr] = await Promise.all([getBlueprint(id).catch(e => ({ _err: e.message })), listRuns(id).catch(() => null)]);
+    if (bp?._err) setErr(bp._err); else setBlueprint(bp?.data || null);
+    setRuns(rr?.data?.runs || []);
+  }, [id]);
+  useEffect(() => { load(); }, [load]);
+
+  return html`
+    <div class="wf-tab">
+      <div class="wf-detail-head">
+        <button class="btn-ghost" onClick=${onBack}>← ${t('profile.workflows.back')}</button>
+        <div class="wf-detail-title">${id}</div>
+        <div class="wf-detail-actions">
+          <button class="btn-ghost" onClick=${onEdit}>${t('profile.workflows.edit')}</button>
+          <button class="btn-outline" onClick=${() => onRun(id, 'signals-only')}>${t('profile.workflows.check')}</button>
+          <button class="btn-primary" onClick=${() => onRun(id, 'full')}>${t('profile.workflows.run')}</button>
+        </div>
+      </div>
+
+      ${err && html`<div class="wf-error">${err}</div>`}
+
+      <div class="wf-section-title">${t('profile.workflows.blueprint')}</div>
+      ${blueprint && html`<div class="wf-graph">
+        ${blueprint.nodes.map(n => html`<div class="wf-node" key=${n.stepId}>
+          <div class="wf-node-id">${n.stepId}</div>
+          <div class="wf-node-agent">${(n.agents || []).join(', ')} · ${n.offerId}</div>
+          ${n.reads.length > 0 && html`<div class="wf-node-io">↘ ${n.reads.join(', ')}</div>`}
+          ${n.writes.length > 0 && html`<div class="wf-node-io">↗ ${n.writes.join(', ')}</div>`}
+          ${(() => {
+            const deps = (blueprint.edges || []).filter(e => e.to === n.stepId).map(e => e.from);
+            return deps.length > 0 ? html`<div class="wf-node-dep">${t('profile.workflows.after')}: ${deps.join(', ')}</div>` : '';
+          })()}
+        </div>`)}
+      </div>`}
+
+      <div class="wf-section-title">${t('profile.workflows.recentRuns')}</div>
+      ${runs.length === 0
+        ? html`<div class="wf-empty">${t('profile.workflows.noRuns')}</div>`
+        : html`<table class="wf-table"><tbody>
+            ${runs.map(r => html`<tr key=${r.runId} class="wf-run-row" onClick=${() => onOpenRun(r.runId)}>
+              <td>${timeAgo(r.startedAt)}</td>
+              <td><${StatusBadge} status=${r.status} /></td>
+              <td class="wf-muted">${r.mode}</td>
+            </tr>`)}
+          </tbody></table>`}
+    </div>`;
+}
+
+// ── Run: per-step timeline ──────────────────────────────────────────────────────
+function RunView({ id, runId, onBack }) {
+  const [run, setRun] = useState(null);
+  const [err, setErr] = useState(null);
+  useEffect(() => { getRun(id, runId).then(r => setRun(r?.data || null)).catch(e => setErr(e.message)); }, [id, runId]);
+
+  return html`
+    <div class="wf-tab">
+      <div class="wf-detail-head">
+        <button class="btn-ghost" onClick=${onBack}>← ${t('profile.workflows.back')}</button>
+        <div class="wf-detail-title">${t('profile.workflows.run')} · ${run ? timeAgo(run.startedAt) : runId.slice(0, 8)}</div>
+        ${run && html`<${StatusBadge} status=${run.status} />`}
+      </div>
+      ${err && html`<div class="wf-error">${err}</div>`}
+      ${run && html`<div class="wf-steps">
+        ${Object.entries(run.steps).map(([stepId, s]) => html`<div class="wf-step" key=${stepId}>
+          <div class="wf-step-row">
+            <${StatusBadge} status=${s.state} />
+            <span class="wf-step-id">${stepId}</span>
+            ${s.reads?.length > 0 && html`<span class="wf-muted">↘ ${s.reads.length}</span>`}
+            ${s.writes?.length > 0 && html`<span class="wf-muted">↗ ${s.writes.length}</span>`}
+            ${s.attempt > 0 && html`<span class="wf-muted">${t('profile.workflows.attempt')} ${s.attempt + 1}</span>`}
+          </div>
+          ${(s.outputObserved || s.inputObserved) && html`<pre class="wf-observed">${JSON.stringify(s.outputObserved || s.inputObserved, null, 2)}</pre>`}
+        </div>`)}
+        ${(run.inspections || []).length > 0 && html`<div class="wf-inspections">${t('profile.workflows.inspectorDispatched', { count: run.inspections.length })}</div>`}
+      </div>`}
+    </div>`;
+}

package/dist/public/views/profile.js

@@ -66,6 +66,7 @@ import CalibratorTab from './profile/calibrator-tab.js';
 import PackagesTab from './profile/packages-tab.js';
 import CapabilitiesTab from './profile/capabilities-tab.js';
 import SchedulerTab from './profile/scheduler-tab.js';
+import WorkflowsTab from './profile/workflows-tab.js';
 
 // Each tab has a minTier: 'new' | 'active' | 'experienced'
 // Tabs with minTier <= current tier are visible in the tab bar.
@@ -75,6 +76,7 @@ const TABS = [
   { id: 'agents',        key: 'profile.tabs.agents',         component: AgentsTab,         minTier: 'active' },
   { id: 'offers',        key: 'profile.tabs.offers',         component: OffersTab,         minTier: 'active' },
   { id: 'scheduler',     key: 'profile.tabs.scheduler',      component: SchedulerTab,      minTier: 'active' },
+  { id: 'workflows',     key: 'profile.tabs.workflows',      component: WorkflowsTab,      minTier: 'active' },
   { id: 'chatsessions',  key: 'profile.tabs.chatSessions',   component: ChatSessionsTab,   minTier: 'active' },
   { id: 'mcp',           key: 'profile.tabs.mcp',            component: McpTab,            minTier: 'active' },
   { id: 'wallet',        key: 'profile.tabs.wallet',         component: WalletTab,         minTier: 'new' },

package/dist/src/cli/connect/mcp/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/connect/mcp/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AA2B7D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAyB9E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/connect/mcp/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AA4B7D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CA0B9E"}

package/dist/src/cli/connect/mcp/tools/index.js

@@ -14,6 +14,7 @@ import { registerKnowledgeTools } from './knowledge.js';
 import { registerOrganismsTools } from './organisms.js';
 import { registerWorkspaceTools } from './workspaces.js';
 import { registerSchedulesTools } from './schedules.js';
+import { registerWorkflowTools } from './workflows.js';
 import { registerConsentTools } from './consent.js';
 import { registerGroupsTools } from './groups.js';
 import { registerInstancesTools } from './instances.js';
@@ -39,6 +40,7 @@ export function registerAllTools(mcp, registry) {
     registerOrganismsTools(mcp, registry);
     registerWorkspaceTools(mcp, registry);
     registerSchedulesTools(mcp, registry);
+    registerWorkflowTools(mcp, registry);
     registerConsentTools(mcp, registry);
     registerGroupsTools(mcp, registry);
     registerInstancesTools(mcp, registry);

package/dist/src/cli/connect/mcp/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/cli/connect/mcp/tools/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/cli/connect/mcp/tools/index.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/connect/mcp/tools/workflows.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @file workflows.ts
+ * @description Connector MCP registrations for the Agent Workflows tools — parity with the server
+ *   MCP (src/mcp/workflows.ts) so `aimeat connect serve --surface agent` exposes the same
+ *   save/get/run tools locally. Thin REST wrappers over /v1/workflows.
+ * @version-history
+ *   v1.0.0 -- 2026-06-13 -- Close the connector-surface gap for workflow_save/get/run.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AgentRegistry } from '../../agent-registry.js';
+export declare function registerWorkflowTools(mcp: McpServer, registry: AgentRegistry): void;
+//# sourceMappingURL=workflows.d.ts.map

package/dist/src/cli/connect/mcp/tools/workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../../../../../src/cli/connect/mcp/tools/workflows.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAI7D,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAmCnF"}

package/dist/src/cli/connect/mcp/tools/workflows.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { annotationsFor } from '../../../../mcp/annotations.js';
+import { descriptionFor } from '../../../../mcp/catalog/shape.js';
+export function registerWorkflowTools(mcp, registry) {
+    const { client } = registry.resolve();
+    const out = (resp) => ({ content: [{ type: 'text', text: JSON.stringify(resp.data ?? resp, null, 2) }], ...(resp.ok === false ? { isError: true } : {}) });
+    mcp.tool('aimeat_workflow_save', descriptionFor('aimeat_workflow_save'), {
+        id: z.string().describe('Workflow id (lowercase slug); existing id = update.'),
+        definition: z.record(z.string(), z.unknown()).describe('The workflow descriptor: { title, description, trigger, vars[], steps[], on_step_fail:"inspect", llm?{approved} }. Validated against the offer contract + DAG on save.'),
+    }, annotationsFor('aimeat_workflow_save'), async ({ id, definition }) => {
+        return out(await client.put(`/v1/workflows/${encodeURIComponent(id)}`, definition));
+    });
+    mcp.tool('aimeat_workflow_get', descriptionFor('aimeat_workflow_get'), {
+        id: z.string().optional().describe('Omit to list all your workflows; pass an id for its definition + derived blueprint + recent runs.'),
+    }, annotationsFor('aimeat_workflow_get'), async ({ id }) => {
+        if (!id)
+            return out(await client.get('/v1/workflows'));
+        const enc = encodeURIComponent(id);
+        const [def, bp, runs] = await Promise.all([
+            client.get(`/v1/workflows/${enc}`),
+            client.get(`/v1/workflows/${enc}/blueprint`),
+            client.get(`/v1/workflows/${enc}/runs`),
+        ]);
+        const recentRuns = ((runs.data?.runs) ?? []).slice(0, 5);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ definition: def.data ?? def, blueprint: bp.ok === false ? null : (bp.data ?? null), recentRuns }, null, 2) }],
+            ...(def.ok === false ? { isError: true } : {}),
+        };
+    });
+    mcp.tool('aimeat_workflow_run', descriptionFor('aimeat_workflow_run'), {
+        id: z.string().describe('The workflow id.'),
+        mode: z.enum(['signals-only', 'full']).describe('signals-only = evaluate each step\'s signals against existing memory (no dispatch — an instant health check); full = execute the steps live.'),
+    }, annotationsFor('aimeat_workflow_run'), async ({ id, mode }) => {
+        return out(await client.post(`/v1/workflows/${encodeURIComponent(id)}/run`, { mode }));
+    });
+}
+//# sourceMappingURL=workflows.js.map

package/dist/src/cli/connect/mcp/tools/workflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../../../../../../src/cli/connect/mcp/tools/workflows.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/connect/tool-call.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-call.d.ts","sourceRoot":"","sources":["../../../../src/cli/connect/tool-call.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,EAA0D,KAAK,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAC/H,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEjE,OAAO,EAA+B,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEpF,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,UAAU,wBAAwB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvC,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CAC9E;AAED,UAAU,eAAe;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACrB;AAkHD,eAAO,MAAM,iBAAiB,EAAE,wBAAwB,EA6+BvD,CAAC;AAyDF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAS/D;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAahE;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAyD5G"}
+{"version":3,"file":"tool-call.d.ts","sourceRoot":"","sources":["../../../../src/cli/connect/tool-call.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,EAA0D,KAAK,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAC/H,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEjE,OAAO,EAA+B,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEpF,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,UAAU,wBAAwB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvC,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CAC9E;AAED,UAAU,eAAe;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACrB;AAkHD,eAAO,MAAM,iBAAiB,EAAE,wBAAwB,EAihCvD,CAAC;AAyDF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAS/D;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAahE;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAyD5G"}

package/dist/src/cli/connect/tool-call.js

@@ -1194,6 +1194,43 @@ export const CONNECT_CLI_TOOLS = [
         input: { name: { type: 'string', required: true, description: 'Cortex name.' } },
         handler: ({ client }, input) => client.delete(`/v1/cortex/${encodeURIComponent(requiredString(input, 'name'))}`),
     },
+    // ── Agent Workflows (shell-callable parity with the MCP + connector surfaces) ──
+    {
+        name: 'aimeat_workflow_save',
+        description: 'Create/update a workflow. `definition` is the full descriptor (title, description, trigger, vars[], steps[], on_step_fail, llm?); validated against the offer contract + DAG on save.',
+        input: {
+            id: { type: 'string', required: true, description: 'Workflow id (lowercase slug); existing id = update.' },
+            definition: { type: 'object', required: true, description: 'The workflow descriptor.' },
+        },
+        handler: ({ client }, input) => client.put(`/v1/workflows/${encodeURIComponent(requiredString(input, 'id'))}`, requiredRecord(input, 'definition')),
+    },
+    {
+        name: 'aimeat_workflow_get',
+        description: 'Inspect workflows. Omit id to list; pass an id for its definition + derived blueprint + recent runs.',
+        input: { id: { type: 'string', description: 'Omit to list; pass for one workflow.' } },
+        handler: async ({ client }, input) => {
+            const id = optionalString(input, 'id');
+            if (!id)
+                return client.get('/v1/workflows');
+            const enc = encodeURIComponent(id);
+            const [def, bp, runs] = await Promise.all([
+                client.get(`/v1/workflows/${enc}`),
+                client.get(`/v1/workflows/${enc}/blueprint`),
+                client.get(`/v1/workflows/${enc}/runs`),
+            ]);
+            const recentRuns = ((runs.data?.runs) ?? []).slice(0, 5);
+            return { ok: def.ok, data: { definition: def.data ?? def, blueprint: bp.ok === false ? null : (bp.data ?? null), recentRuns } };
+        },
+    },
+    {
+        name: 'aimeat_workflow_run',
+        description: 'Run a workflow. mode="signals-only" evaluates signals against memory (no dispatch — instant health check); mode="full" executes the steps.',
+        input: {
+            id: { type: 'string', required: true, description: 'The workflow id.' },
+            mode: { type: 'string', required: true, description: 'signals-only | full' },
+        },
+        handler: ({ client }, input) => client.post(`/v1/workflows/${encodeURIComponent(requiredString(input, 'id'))}/run`, { mode: requiredString(input, 'mode') }),
+    },
 ];
 function getTool(name) {
     return CONNECT_CLI_TOOLS.find(tool => tool.name === name);