loopengine 0.3.3 → 0.3.5

package/dist/core/run-events.d.ts

@@ -0,0 +1,21 @@
+import type { Message } from './run-agent.js';
+export type RunEventSource = 'workflow' | 'schedule' | 'message' | 'slack' | 'telegram';
+export interface RunEvent {
+    at: string;
+    agent: string;
+    source: RunEventSource;
+    /** The same for every report of the same job. */
+    id: string;
+    /** workflow only: how the run started. */
+    via?: string;
+    /** message only. */
+    caller?: 'api' | 'console' | 'unknown';
+    usedTool: boolean;
+}
+export type RunObserver = (event: RunEvent) => void;
+/** Sets the one observer for this process; undefined removes it. */
+export declare function setRunObserver(next: RunObserver | undefined): void;
+/** Never throws: a broken observer must not fail the job. */
+export declare function reportRun(event: Omit<RunEvent, 'at'>): void;
+/** Whether a turn's new messages include a tool call by the agent. */
+export declare function usedTool(newMessages: Message[]): boolean;

package/dist/core/run-events.js

@@ -0,0 +1,20 @@
+let observer;
+/** Sets the one observer for this process; undefined removes it. */
+export function setRunObserver(next) {
+    observer = next;
+}
+/** Never throws: a broken observer must not fail the job. */
+export function reportRun(event) {
+    if (!observer)
+        return;
+    try {
+        observer({ ...event, at: new Date().toISOString() });
+    }
+    catch (err) {
+        console.error('[loopengine] run observer failed:', err instanceof Error ? err.message : err);
+    }
+}
+/** Whether a turn's new messages include a tool call by the agent. */
+export function usedTool(newMessages) {
+    return newMessages.some((m) => m.role === 'assistant' && Array.isArray(m.content) && m.content.some((b) => b.type === 'tool_use'));
+}

package/dist/core/workflows.d.ts

@@ -8,17 +8,26 @@ export interface Workflow {
     /** A name for people, e.g. "Refund check". */
     title: string;
     description: string;
+    /** A workflow saved before instructions: what its runs began with. Empty
+     * for one saved since. */
     startMessage: string;
-    /** When it runs, in plain words: "Every Monday at 9", "When asked". */
+    /** A label from before, in words ("Every Monday at 9"); "When asked"
+     * when there's none. Nothing reads it to decide when to run. */
     trigger: string;
     parameters: Record<string, WorkflowParameter>;
-    /** Its steps: the skill body, placeholders unfilled. */
+    /** The skill body, placeholders unfilled. */
     steps: string;
+    /** What the agent does, as one text: the body, with an older
+     * workflow's start message in front of it. What the editor shows. */
+    instructions: string;
 }
-/** The front matter that makes a skill a workflow. */
+/** The front matter that makes a skill a workflow: `instructions` (the
+ * new way) replaces the body and drops any start message and label;
+ * `startMessage` (from before) is kept for workflows saved that way. */
 export interface WorkflowFields {
     title?: string;
-    startMessage: string;
+    instructions?: string;
+    startMessage?: string;
     trigger?: string;
     parameters?: Record<string, WorkflowParameter>;
 }

package/dist/core/workflows.js

@@ -1,25 +1,34 @@
 // An agent's workflows: skills it can be told to run, by hand, from an app
 // over the API, or on a schedule. A workflow is a skill
-// (agents/<name>/skills/<id>/SKILL.md) whose front matter also says how a
-// run starts:
+// (agents/<name>/skills/<id>/SKILL.md) marked as one, with a title and the
+// values a run is given:
 //
 //   ---
 //   name: refund-check
 //   description: Check a refund request against the order and our policy
+//   workflow: true
 //   title: Refund check
-//   start_message: Check the refund request for order $order_number.
-//   trigger: When a refund request comes in
 //   parameters:
 //     order_number: { description: The order to check, required: true }
 //     customer_note: { description: What the customer wrote }
 //   ---
+//   Check the refund request for order $order_number.
 //   1. Look up order $order_number…
 //
-// The body is its steps. A run starts with the start message and those
-// steps, with each $parameter filled in, so the model has them from its
-// first turn rather than picking the skill from its index. None of these
-// keys reach the model otherwise: the skill index shows only a skill's
-// name and description (core/skillgarden).
+// The body is its instructions: one text, edited as one. A run starts with
+// a line naming the workflow and those instructions, with each $parameter
+// filled in, so the model has them from its first turn rather than
+// picking the skill from its index. In chat, the agent loads the same
+// body through the Skill tool. None of the workflow keys reach the model
+// otherwise: the skill index shows only a skill's name and description
+// (core/skillgarden).
+//
+// What starts a run (schedules, webhooks) isn't kept here: it's the
+// workflow's schedules and webhook triggers themselves.
+//
+// Workflows saved before had a separate start_message (a skill with one
+// is still a workflow) and a `trigger` label; both are folded into the
+// instructions the next time the workflow is saved.
 //
 // Agents from before kept their workflows in workflows.yml;
 // migrateWorkflowsFile moves those into their skills.
@@ -30,7 +39,7 @@ import { parseSkillFile, substituteParameters } from './skillgarden/index.js';
 export class WorkflowParamsError extends Error {
 }
 const PARAMETER_NAME = /^[a-z_][a-z0-9_]*$/;
-const WORKFLOW_KEYS = ['title', 'start_message', 'trigger', 'parameters'];
+const WORKFLOW_KEYS = ['workflow', 'title', 'start_message', 'trigger', 'parameters'];
 function skillsDir(agentDir) {
     return join(agentDir, 'skills');
 }
@@ -72,9 +81,19 @@ function parametersFrom(value) {
     }
     return parameters;
 }
+/** An older workflow's start message and body as one text; the body
+ * alone when it already begins with the start message. */
+function combineInstructions(startMessage, body) {
+    const steps = body.trim();
+    if (!startMessage)
+        return steps;
+    if (steps.startsWith(startMessage))
+        return steps;
+    return steps ? `${startMessage}\n\n${steps}` : startMessage;
+}
 function workflowFrom(id, frontmatter, body) {
     const startMessage = typeof frontmatter.start_message === 'string' ? frontmatter.start_message.trim() : '';
-    if (!startMessage)
+    if (frontmatter.workflow !== true && !startMessage)
         return undefined;
     return {
         id,
@@ -84,6 +103,7 @@ function workflowFrom(id, frontmatter, body) {
         trigger: typeof frontmatter.trigger === 'string' && frontmatter.trigger.trim() ? frontmatter.trigger.trim() : 'When asked',
         parameters: parametersFrom(frontmatter.parameters),
         steps: body,
+        instructions: combineInstructions(startMessage, body),
     };
 }
 /** The agent's workflows: its skills that have a start message. */
@@ -121,12 +141,19 @@ export function setWorkflowFields(agentDir, id, fields) {
     const frontmatter = { ...skill.frontmatter };
     for (const key of WORKFLOW_KEYS)
         delete frontmatter[key];
+    const parameters = fields.parameters && Object.keys(fields.parameters).length ? { parameters: fields.parameters } : {};
+    if (fields.instructions !== undefined) {
+        writeSkillFile(path, { ...frontmatter, workflow: true, ...(fields.title ? { title: fields.title } : {}), ...parameters }, fields.instructions);
+        return;
+    }
+    if (!fields.startMessage)
+        throw new Error('A workflow needs its instructions.');
     writeSkillFile(path, {
         ...frontmatter,
         ...(fields.title ? { title: fields.title } : {}),
         start_message: fields.startMessage,
         ...(fields.trigger ? { trigger: fields.trigger } : {}),
-        ...(fields.parameters && Object.keys(fields.parameters).length ? { parameters: fields.parameters } : {}),
+        ...parameters,
     }, skill.body);
 }
 /** Stops a skill being a workflow. The skill itself stays. */
@@ -182,13 +209,15 @@ export function workflowRunMessage(workflow, params = {}) {
     // Named placeholders only: positional $1-style filling would eat dollar
     // amounts like "$50" in the steps.
     const fill = (text) => substituteParameters(text, params, { declared, used });
-    const start = fill(workflow.startMessage);
+    // An older workflow begins with its own start message; one saved since
+    // with a line naming it, its instructions saying the rest.
+    const start = workflow.startMessage ? fill(workflow.startMessage) : `Run the "${workflow.title}" workflow.`;
     const steps = fill(workflow.steps).trim();
     const unused = Object.entries(params).filter(([name]) => !used.has(name));
     return [
         start,
         unused.length ? `Inputs:\n${unused.map(([name, value]) => `- ${name}: ${value}`).join('\n')}` : '',
-        steps ? `These are the steps, from your "${workflow.id}" skill:\n\n${steps}` : '',
+        steps ? `${workflow.startMessage ? 'These are the steps' : 'These are its instructions'}, from your "${workflow.id}" skill:\n\n${steps}` : '',
     ].filter(Boolean).join('\n\n');
 }
 export function legacyWorkflowsPath(agentDir) {

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export { createAgentEnv, agentDirFor, envScopeOf, type EnvScope } from '#core/ag
 export { FileSecretStore, setSecretStore, getSecretStore, type SecretStore } from '#core/secret-store.js';
 export { signProxyIdentity, verifyProxyIdentity, TRUSTED_PROXY_IDENTITY_HEADER, type ProxyIdentity } from '#core/trusted-proxy.js';
 export { setUsageSink, recordUsage, type UsageEvent, type UsageSink } from '#core/usage.js';
+export { setRunObserver, reportRun, usedTool, type RunEvent, type RunEventSource, type RunObserver } from '#core/run-events.js';
 export { readNotifierFile, writeNotifierFile, removeNotifierFile, validateNotifierFile, notifierConfigFromFile, NotifierFileError, NOTIFIER_SECRET_VARS, type NotifierFile, type MessagingApprover } from '#core/notifier-file.js';
 export { listDeliveries, recordDelivery, type NotifierDelivery } from '#core/notifier-deliveries.js';
 export { describeNotifier } from '#core/http-notifier.js';

package/dist/index.js

@@ -9,6 +9,7 @@ export { createAgentEnv, agentDirFor, envScopeOf } from '#core/agent-env.js';
 export { FileSecretStore, setSecretStore, getSecretStore } from '#core/secret-store.js';
 export { signProxyIdentity, verifyProxyIdentity, TRUSTED_PROXY_IDENTITY_HEADER } from '#core/trusted-proxy.js';
 export { setUsageSink, recordUsage } from '#core/usage.js';
+export { setRunObserver, reportRun, usedTool } from '#core/run-events.js';
 export { readNotifierFile, writeNotifierFile, removeNotifierFile, validateNotifierFile, notifierConfigFromFile, NotifierFileError, NOTIFIER_SECRET_VARS } from '#core/notifier-file.js';
 export { listDeliveries, recordDelivery } from '#core/notifier-deliveries.js';
 export { describeNotifier } from '#core/http-notifier.js';

package/dist/web/agents-config-page.js

@@ -667,8 +667,9 @@ ${consoleShellScript}
       (cfg.abilityCount != null
         ? card('abilities', 'Apps', String(cfg.abilityCount), cfg.abilityCount ? 'Apps and abilities added to this agent' : 'Add apps and abilities, with the tools you choose')
         : card('abilities', 'Apps', 'Browse', 'Add apps and abilities, with the tools you choose')) +
-      card('tools', 'Tools', String(cfg.tools.length), escapeHtml(toolNames.slice(0, 3).join(', ') + (toolNames.length > 3 ? ', \u2026' : '')) || 'None yet') +
-      card('skills', 'Skills', String(cfg.skills.length), escapeHtml(cfg.skills.map(function (k) { return k.name; }).join(', ')) || 'None yet') +
+      card('workflows', 'Workflows', '<span id="ovWorkflowsValue">&hellip;</span>', '<span id="ovWorkflowsDetail">Loading&hellip;</span>') +
+      card('tools', 'Tools &amp; skills', cfg.tools.length + (cfg.tools.length === 1 ? ' tool' : ' tools'),
+        (cfg.skills.length + (cfg.skills.length === 1 ? ' skill' : ' skills')) + (toolNames.length ? ' \u00b7 ' + escapeHtml(toolNames.slice(0, 2).join(', ') + (toolNames.length > 2 ? ', \u2026' : '')) : '')) +
       card('actauth', 'Permissions', rules.length + (rules.length === 1 ? ' rule' : ' rules'),
         (asks ? asks + ' need approval \u00b7 ' : '') + 'unmatched calls: ' + escapeHtml(cfg.permissions.defaultDecision)) +
       card('messaging', 'Messaging', '<span id="ovMessagingValue">&hellip;</span>', '<span id="ovMessagingDetail">Loading&hellip;</span>') +
@@ -683,8 +684,48 @@ ${consoleShellScript}
   // cards are filled in once those answer. Called after every render of
   // Overview, which is also re-rendered after edits.
   // ---- Overview: the agent's workflows (web/workflow-admin.ts), added
-  // from "Describe a workflow": each with its trigger, its schedule's
-  // state, its steps (checkpoints marked) and Run now. ----
+  // from "Describe a workflow": each with its instructions, what starts it
+  // (its real schedules and webhooks), its recent runs and Run now. ----
+
+  // What starts a workflow, in a few words, from its schedules and
+  // webhooks: never a label that could say something else.
+  function workflowStartsSummary(w) {
+    var parts = (w.schedules || []).filter(function (x) { return x.repeating && x.status !== 'paused'; }).map(function (x) { return x.describe; });
+    if (w.webhooks) parts.push(w.webhooks === 1 ? 'when its webhook is called' : 'when one of its ' + w.webhooks + ' webhooks is called');
+    if (!parts.length) return 'When asked';
+    var text = parts.join(', and ');
+    return text.charAt(0).toUpperCase() + text.slice(1);
+  }
+
+  // How it starts: each schedule (pause, resume, remove), its webhooks,
+  // and Run now or the API, which always work.
+  function workflowStartsHtml(w) {
+    var schedules = (w.schedules || []).map(function (x) {
+      var state = x.waiting ? '<span class="le-pill ask">Waiting for a decision</span>'
+        : x.status === 'paused' ? '<span class="le-pill">Paused</span>'
+        : x.status === 'running' ? '<span class="le-pill accent">Running</span>'
+        : (x.nextRunAt ? '<span class="hint">next ' + escapeHtml(new Date(x.nextRunAt).toLocaleString()) + '</span>' : '');
+      var values = x.params ? Object.keys(x.params).map(function (k) { return escapeHtml(k) + ': ' + escapeHtml(x.params[k]); }).join(' ' + String.fromCharCode(183) + ' ') : '';
+      return '<li style="display:flex;gap:8px;flex-wrap:wrap;align-items:center">' +
+        '<span>' + escapeHtml(x.describe.charAt(0).toUpperCase() + x.describe.slice(1)) + (x.name ? ' <span class="hint">(' + escapeHtml(x.name) + ')</span>' : '') + '</span>' + state +
+        (values ? '<span class="hint">' + values + '</span>' : '') +
+        (x.notify ? '<span class="hint">sends you each result</span>' : '') +
+        '<span style="display:flex;gap:6px;margin-left:auto">' +
+          (x.status === 'paused' ? '<button type="button" class="workflow-schedule-action" data-id="' + escapeHtml(x.taskId) + '" data-action="resume">Resume</button>'
+            : x.status === 'scheduled' ? '<button type="button" class="workflow-schedule-action" data-id="' + escapeHtml(x.taskId) + '" data-action="pause">Pause</button>' : '') +
+          '<button type="button" class="delete-btn workflow-schedule-action" data-id="' + escapeHtml(x.taskId) + '" data-action="cancel">Remove</button>' +
+        '</span></li>';
+    }).join('');
+    return '<div class="body-field workflow-starts" style="margin:6px 0 0">How it starts' +
+      '<ul class="schedule-history" style="margin:4px 0 0">' + schedules +
+        (w.webhooks ? '<li>' + (w.webhooks === 1 ? 'A webhook' : w.webhooks + ' webhooks') + ' <span class="hint">another app calls it when something happens</span></li>' : '') +
+        '<li class="hint">Run now, below, or an app' + String.fromCharCode(8217) + 's API call, any time</li>' +
+      '</ul>' +
+      '<div style="display:flex;gap:6px;flex-wrap:wrap;margin-top:6px">' +
+        '<button type="button" class="workflow-add-schedule">Add a schedule</button>' +
+        '<button type="button" class="workflow-hooks-btn">' + (w.webhooks ? 'Webhooks' : 'Add a webhook') + '</button>' +
+      '</div></div>';
+  }
 
   function renderWorkflowsHtml(name, workflows) {
     if (!workflows.length) {
@@ -693,7 +734,7 @@ ${consoleShellScript}
     return workflows.map(function (w) {
       var s = w.schedule;
       var state = !s
-        ? '<span class="hint">' + escapeHtml(w.trigger) + '</span>'
+        ? '<span class="hint">' + escapeHtml(workflowStartsSummary(w)) + '</span>'
         : s.waiting
           ? '<span class="le-pill ask">Waiting for a decision</span>'
           : s.status === 'paused'
@@ -707,7 +748,6 @@ ${consoleShellScript}
         return '<label class="workflow-param">' + escapeHtml(p) + (spec.required ? '' : ' <span class="hint">(optional)</span>') +
           '<input name="' + escapeHtml(p) + '"' + (spec.required ? ' required' : '') + ' placeholder="' + escapeHtml(spec.description || '') + '"></label>';
       }).join('');
-      var scheduleCount = (w.schedules || []).filter(function (x) { return x.repeating; }).length;
       var runs = (w.recentRuns || []).map(function (r) {
         var pill = r.status === 'done' ? '<span class="le-pill good">Done</span>'
           : r.status === 'error' ? '<span class="le-pill bad">Failed</span>'
@@ -722,22 +762,44 @@ ${consoleShellScript}
       return '<div class="source workflow-card" data-workflow="' + escapeHtml(w.id) + '">' +
         '<div style="display:flex;justify-content:space-between;gap:10px;flex-wrap:wrap;align-items:baseline">' +
           '<strong>' + escapeHtml(w.title) + '</strong><span>' + state + '</span></div>' +
-        '<p class="hint" style="margin:4px 0 6px">' + escapeHtml(w.description) + (s ? ' ' + String.fromCharCode(183) + ' ' + escapeHtml(w.trigger) : '') + '</p>' +
-        '<details><summary class="hint">Steps <span>(the ' + escapeHtml(w.id) + ' skill)</span></summary><div class="workflow-steps-text">' + escapeHtml(w.steps) + '</div></details>' +
+        '<p class="hint" style="margin:4px 0 6px">' + escapeHtml(w.description) + (s ? ' ' + String.fromCharCode(183) + ' ' + escapeHtml(workflowStartsSummary(w)) : '') + '</p>' +
+        '<details><summary class="hint">Instructions <span>(the ' + escapeHtml(w.id) + ' skill)</span></summary><div class="workflow-steps-text">' + escapeHtml(w.instructions) + '</div></details>' +
+        workflowStartsHtml(w) +
         (params ? '<div class="workflow-params">' + params + '</div>' : '') +
         (runs ? '<details class="workflow-runs"' + ((w.recentRuns || []).some(function (r) { return r.status === 'running' || r.status === 'awaiting_approval'; }) ? ' open' : '') + '><summary class="hint">Recent runs (' + w.recentRuns.length + ')</summary><ul class="schedule-history">' + runs + '</ul></details>' : '') +
         '<div style="display:flex;gap:6px;flex-wrap:wrap;margin-top:8px">' +
           '<button type="button" class="workflow-run">Run now</button>' +
-          (scheduleCount ? '<a href="?tab=schedules" data-tab="schedules" class="hint" style="align-self:center">' + (scheduleCount > 1 ? 'Schedules (' + scheduleCount + ')' : 'Schedule') + '</a>' : '') +
           '<button type="button" class="workflow-edit">Edit</button>' +
-          '<button type="button" class="workflow-hooks-btn">Webhooks</button>' +
-          '<a href="?tab=skills" data-tab="skills" class="hint" style="align-self:center">Edit steps</a>' +
           '<button type="button" class="delete-btn workflow-forget">Forget</button>' +
         '</div><div class="hint workflow-result"></div><div class="workflow-editor" hidden></div><div class="workflow-hooks" hidden></div></div>';
     }).join('') + '<p class="hint" style="margin:6px 0 0"><a href="/workflows/new">Describe another workflow</a></p>';
   }
 
+  // The Overview's Workflows tile: how many, the next scheduled run, and
+  // any waiting for a decision.
+  function fillWorkflowsCard(workflows) {
+    var value = detail.querySelector('#ovWorkflowsValue');
+    var detailEl = detail.querySelector('#ovWorkflowsDetail');
+    if (!value || !detailEl) return;
+    value.textContent = String(workflows.length);
+    var next = null;
+    var waiting = 0;
+    workflows.forEach(function (w) {
+      (w.schedules || []).forEach(function (x) {
+        if (x.waiting) waiting++;
+        if (x.status === 'scheduled' && x.nextRunAt && (!next || x.nextRunAt < next)) next = x.nextRunAt;
+      });
+      (w.recentRuns || []).forEach(function (r) { if (r.status === 'awaiting_approval') waiting++; });
+    });
+    var parts = [];
+    if (waiting) parts.push(waiting + ' waiting for a decision');
+    if (next) parts.push('next run ' + new Date(next).toLocaleString());
+    detailEl.textContent = parts.join(' \u00b7 ') || (workflows.length ? 'Run by hand, by an app or a webhook' : 'Describe a job for this agent to do');
+  }
+
   var workflowsRefreshTimer = null;
+  // Set by a workflow's "Add a schedule", for the Schedules tab's form.
+  var pendingScheduleWorkflow = null;
   var workflowsById = {};
   // Set while a workflow's editor is open, so the running-run refresh
   // doesn't redraw the card under someone typing.
@@ -751,6 +813,7 @@ ${consoleShellScript}
       if (currentName !== name) return;
       if (!r.ok) { el.innerHTML = '<p class="error">Could not load workflows: ' + escapeHtml(r.body.error || 'unknown error') + '</p>'; return; }
       var workflows = r.body.workflows || [];
+      fillWorkflowsCard(workflows);
       workflowsById = {};
       workflows.forEach(function (w) { workflowsById[w.id] = w; });
       el.innerHTML = renderWorkflowsHtml(name, workflows);
@@ -758,12 +821,12 @@ ${consoleShellScript}
       for (var i = 0; i < cards.length; i++) wireWorkflowCard(name, cards[i]);
       // Keep a running run's status current while the Overview is open.
       var running = workflows.some(function (w) { return (w.recentRuns || []).some(function (x) { return x.status === 'running'; }); });
-      if (running && currentTab === 'overview') workflowsRefreshTimer = setTimeout(function () { if (!workflowEditing) loadWorkflowsSection(name); }, 3000);
+      if (running && currentTab === 'workflows') workflowsRefreshTimer = setTimeout(function () { if (!workflowEditing) loadWorkflowsSection(name); }, 3000);
     });
   }
 
-  // ---- The workflow editor: how a workflow's runs start. Its steps are
-  // the skill body, edited on the Skills tab.
+  // ---- The workflow editor: its title, its instructions (the skill body)
+  // and the values a run is given. What starts it is on the card.
   function workflowParamRowHtml(pname, spec) {
     return '<div class="workflow-param-row">' +
       '<input class="wp-name" aria-label="Parameter name" placeholder="order_number" value="' + escapeHtml(pname || '') + '">' +
@@ -776,9 +839,8 @@ ${consoleShellScript}
     var rows = Object.keys(w.parameters || {}).map(function (p) { return workflowParamRowHtml(p, w.parameters[p]); }).join('');
     return '<form class="add-source workflow-editor-form" style="margin-top:10px">' +
       '<label>Title<input name="title" maxlength="120" value="' + escapeHtml(w.title) + '"></label>' +
-      '<label>Start message <span class="hint">(what each run begins with; $name puts in a parameter&#39;s value)</span>' +
-        '<textarea name="start_message" maxlength="4000" required>' + escapeHtml(w.startMessage) + '</textarea></label>' +
-      '<label>When it runs <span class="hint">(in words, for people; the timing itself is its schedule)</span><input name="trigger" maxlength="200" value="' + escapeHtml(w.trigger) + '"></label>' +
+      '<label>Instructions <span class="hint">(what the agent does, step by step; $name puts in a parameter&#39;s value. Chat uses them too.)</span>' +
+        '<textarea name="instructions" maxlength="12000" rows="12" required>' + escapeHtml(w.instructions) + '</textarea></label>' +
       '<div class="body-field">Parameters <span class="hint">(values a run is given; apps send them as params)</span>' +
         '<div class="workflow-param-rows">' + rows + '</div>' +
         '<button type="button" class="wp-add" style="align-self:flex-start">Add parameter</button></div>' +
@@ -787,12 +849,12 @@ ${consoleShellScript}
       '<div class="hint workflow-editor-result"></div></form>';
   }
 
-  // Placeholders used in the start message or steps that no parameter
-  // declares, and declared parameters nothing uses.
+  // Placeholders the instructions use that no parameter declares, and
+  // declared parameters nothing uses.
   function workflowPlaceholderCheck(w, form) {
     var used = {};
     var pattern = new RegExp('[$]([a-z_][a-z0-9_]*)', 'g');
-    var text = form.querySelector('[name="start_message"]').value + ' ' + (w.steps || '');
+    var text = form.querySelector('[name="instructions"]').value;
     var m;
     while ((m = pattern.exec(text))) used[m[1]] = true;
     var declared = {};
@@ -802,7 +864,7 @@ ${consoleShellScript}
     var missing = Object.keys(used).filter(function (n) { return !declared[n]; });
     var unused = Object.keys(declared).filter(function (n) { return !used[n]; });
     if (missing.length) notes.push('Uses ' + missing.map(function (n) { return '$' + n; }).join(', ') + ', which ' + (missing.length > 1 ? 'aren' : 'isn') + String.fromCharCode(8217) + 't a parameter: add ' + (missing.length > 1 ? 'them' : 'it') + ', or the text stays as written.');
-    if (unused.length) notes.push(unused.join(', ') + ' ' + (unused.length > 1 ? 'aren' : 'isn') + String.fromCharCode(8217) + 't used in the start message or steps: its value is passed as an input.');
+    if (unused.length) notes.push(unused.join(', ') + ' ' + (unused.length > 1 ? 'aren' : 'isn') + String.fromCharCode(8217) + 't used in the instructions: its value is passed as an input.');
     form.querySelector('.workflow-editor-check').textContent = notes.join(' ');
   }
 
@@ -843,7 +905,7 @@ ${consoleShellScript}
       result.textContent = 'Saving' + String.fromCharCode(8230);
       fetchJsonRetryOnce('/agents/' + encodeURIComponent(name) + '/workflows/' + encodeURIComponent(w.id), {
         method: 'PUT', headers: { 'content-type': 'application/json' },
-        body: JSON.stringify({ title: form.title.value, start_message: form.start_message.value, trigger: form.trigger.value, parameters: parameters }),
+        body: JSON.stringify({ title: form.title.value, instructions: form.instructions.value, parameters: parameters }),
       }).then(function (r) {
         if (!r.ok) { result.textContent = r.body.error || 'Could not save'; return; }
         workflowEditing = false;
@@ -1040,6 +1102,21 @@ ${consoleShellScript}
     var base = '/agents/' + encodeURIComponent(name) + '/workflows/' + encodeURIComponent(id);
     card.querySelector('.workflow-edit').addEventListener('click', function () { openWorkflowEditor(name, card); });
     card.querySelector('.workflow-hooks-btn').addEventListener('click', function () { openWorkflowHooks(name, card); });
+    // Add a schedule: the Schedules tab's form, with this workflow chosen.
+    card.querySelector('.workflow-add-schedule').addEventListener('click', function () {
+      pendingScheduleWorkflow = id;
+      switchTab('schedules');
+    });
+    var scheduleBtns = card.querySelectorAll('.workflow-schedule-action');
+    for (var sb = 0; sb < scheduleBtns.length; sb++) {
+      scheduleBtns[sb].addEventListener('click', function (ev) {
+        var btn = ev.currentTarget;
+        var action = btn.dataset.action;
+        if (action === 'cancel' && btn.dataset.confirming !== '1') { btn.dataset.confirming = '1'; btn.textContent = 'Click again to remove'; return; }
+        btn.disabled = true;
+        fetchJsonRetryOnce('/schedules/' + encodeURIComponent(btn.dataset.id) + '/' + action, { method: 'POST' }).then(function () { loadWorkflowsSection(name); });
+      });
+    }
     card.querySelector('.workflow-run').addEventListener('click', function (ev) {
       var btn = ev.currentTarget;
       var params = {};
@@ -1153,7 +1230,6 @@ ${consoleShellScript}
     }
 
     return renderOverviewCards(cfg) +
-      '<section id="workflowsSection"><h3>Workflows</h3><div id="workflowsContent"><p class="hint">Loading&hellip;</p></div></section>' +
       '<section>' + systemPromptSection + '</section>' +
       '<section>' + modelSection + '</section>' +
       '<section><h3>Hooks</h3><dl class="kv">' +
@@ -2353,6 +2429,14 @@ ${consoleShellScript}
           '<input name="param:' + escapeHtml(p) + '" placeholder="' + escapeHtml(parameters[p].description || '') + '"></label>';
       }).join('');
     }
+    // Opened from a workflow's "Add a schedule": that workflow, chosen.
+    if (pendingScheduleWorkflow && workflowSelect) {
+      workflowSelect.value = pendingScheduleWorkflow;
+      var runsWorkflowRadio = form.querySelector('#runsWorkflow');
+      if (runsWorkflowRadio) runsWorkflowRadio.checked = true;
+      form.scrollIntoView({ block: 'start' });
+    }
+    pendingScheduleWorkflow = null;
     renderScheduleParams();
     if (workflowSelect) workflowSelect.addEventListener('change', renderScheduleParams);
     for (var k = 0; k < runsRadios.length; k++) {
@@ -4147,7 +4231,7 @@ ${consoleShellScript}
 
   // ---- Tab switching + agent selection ----
 
-  var CONFIG_TABS = ['overview', 'abilities', 'actauth', 'messaging', 'schedules', 'env', 'advanced'];
+  var CONFIG_TABS = ['overview', 'workflows', 'abilities', 'actauth', 'messaging', 'schedules', 'env', 'advanced'];
   // The old Tools and Skills tabs: now parts of Advanced. A link to one
   // opens Advanced at that part.
   // The Apps tab keeps the id 'abilities'; ?tab=apps opens it too.
@@ -4284,6 +4368,11 @@ ${consoleShellScript}
       }) +
       '<div class="le-scroll"><div class="le-page" style="display:block">' +
       '<div class="tab-panel" data-tab-panel="overview">' + renderOverviewHtml(cfg) + '</div>' +
+      // Workflows: the jobs this agent does, each with what starts it.
+      '<div class="tab-panel" data-tab-panel="workflows">' +
+        '<p class="muted" style="margin:0 0 20px">The jobs this agent does on its own: what it does, what starts it (schedules, webhooks, Run now or an app&#39;s API call) and how its runs went. In Chat it can do them too, when you ask.</p>' +
+        '<section id="workflowsSection"><div id="workflowsContent"><p class="hint">Loading&hellip;</p></div></section>' +
+      '</div>' +
       // Advanced: the agent's own tools (and Composio, subagents), then its
       // own skills. Each part keeps its old data-tab-panel name, which the
       // code that redraws it looks for; only .tab-panel is shown or hidden.

package/dist/web/console-shell.js

@@ -56,7 +56,7 @@ export const consoleShellScript = `<script>
   // ability on the Apps tab (id 'abilities', so older links still work).
   // ?tab=tools and ?tab=skills still open Advanced.
   var TABS = [
-    ['overview', 'Overview'], ['chat', 'Chat'], ['abilities', 'Apps'], ['actauth', 'Permissions'],
+    ['overview', 'Overview'], ['workflows', 'Workflows'], ['chat', 'Chat'], ['abilities', 'Apps'], ['actauth', 'Permissions'],
     ['messaging', 'Messaging'], ['schedules', 'Schedules'], ['env', 'Environment'], ['advanced', 'Advanced']
   ];
 

package/dist/web/workflow-admin.d.ts

@@ -5,6 +5,7 @@ import { type GeneratedMcpAbility, type McpAbilityRequest } from '../core/mcp-ab
 import type { McpDirectoryServer } from '../core/mcp-directory.js';
 import { type Workflow } from '../core/workflows.js';
 import { type WorkflowRun } from '../core/workflow-runs.js';
+import { type ScheduledTask } from '../core/scheduler.js';
 import type { ModelCall } from '../core/run-agent.js';
 export declare class WorkflowError extends Error {
 }
@@ -162,6 +163,9 @@ type WorkflowScheduleView = {
     taskId: string;
     status: string;
     repeating: boolean;
+    describe: string;
+    name?: string;
+    notify: boolean;
     params?: Record<string, string>;
     nextRunAt?: string;
     lastRunAt?: string;
@@ -175,7 +179,12 @@ export interface AgentWorkflowView extends Workflow {
     schedules: WorkflowScheduleView[];
     /** Its latest runs started by hand or by an app, newest first. */
     recentRuns: WorkflowRun[];
+    /** Its webhook triggers that are on. */
+    webhooks: number;
 }
+/** A schedule in words, in its time zone: "every day at 18:05", "every
+ * Monday at 09:00", "every 10 minutes", "once on Nov 6 at 18:05". */
+export declare function plainSchedule(schedule: ScheduledTask['schedule']): string;
 /** Moves an agent's workflows.yml, from before workflows were skills, into
  * its skills, and points the schedules it linked by name at the workflows
  * they run. Safe to call any time: it does nothing once the file is gone. */
@@ -192,9 +201,11 @@ export declare function prepareWorkflowRun(agentName: string, agentDir: string,
     params: Record<string, string>;
     message: string;
 }>;
-/** Changes how a workflow's runs start, from the console's workflow
- * editor: its title, start message, trigger and parameters. Its steps
- * (the skill body) and the skill's other front matter are kept. */
+/** Changes a workflow from the console's editor: its title, its
+ * instructions (the skill body, which an older workflow's start message
+ * and label are folded into), and its parameters. The skill's other front
+ * matter is kept. A body with `start_message` (and no `instructions`) is
+ * still taken, as before. */
 export declare function updateWorkflow(agentDir: string, id: string, input: Record<string, unknown>): Workflow;
 /** Forgets a workflow: its skill stays, as a plain skill, and the
  * schedules that ran it are cancelled. Returns how many were. */

package/dist/web/workflow-admin.js

@@ -11,12 +11,12 @@ import { writeSkill } from './skills-admin.js';
 import { createFromTemplateObject, installFailureReason, templateChecklist } from './templates-admin.js';
 import { templateScheduleStart } from '../core/system-agents/templates.js';
 import { planParameters, planWebhook, planWorkflowWithModel, slugify, workflowTemplate } from '../core/system-agents/workflow-planner.js';
-import { createTrigger, publicTrigger } from '../core/workflow-triggers.js';
+import { createTrigger, listTriggers, publicTrigger } from '../core/workflow-triggers.js';
 import { mcpAbilityNames } from '../core/mcp-ability-generator.js';
 import { clearWorkflowFields, migrateWorkflowsFile, readWorkflow, readWorkflows, setWorkflowFields, validateParams, workflowRunMessage } from '../core/workflows.js';
 import { isUnderWay, listRuns } from '../core/workflow-runs.js';
-import { cancelScheduledTask, createScheduledTask, getSchedulerStore, listScheduledTasks, pauseScheduledTask } from '../core/scheduler.js';
-import { workspaceTimeZone } from '../core/time-zone.js';
+import { cancelScheduledTask, createScheduledTask, describeSchedule, getSchedulerStore, listScheduledTasks, pauseScheduledTask } from '../core/scheduler.js';
+import { wallTimeAt, workspaceTimeZone } from '../core/time-zone.js';
 export class WorkflowError extends Error {
 }
 /** Checks a plan against the agent it would be added to. */
@@ -316,7 +316,7 @@ async function makePlannedWebhook(plan, agent, agentDir) {
             webhook: { trigger: publicTrigger(trigger), token, ...(webhook.setup ? { setup: webhook.setup } : {}) },
             checklist: [{
                     label: `Turn on the ${webhook.name} webhook: paste its URL into ${SENDER_NAMES[webhook.sender]}'s webhook settings, then add the signing secret ${webhook.sender === 'custom' ? 'your app signs with' : 'it shows'}`,
-                    href: `/agents/config?agent=${encodeURIComponent(agent)}&tab=overview`,
+                    href: `/agents/config?agent=${encodeURIComponent(agent)}&tab=workflows`,
                 }],
         };
     }
@@ -342,7 +342,9 @@ export async function createWorkflow(input, deps) {
     // matter. Its parameters are tidied again, as the plan may have been
     // edited on the review screen.
     const { parameters } = planParameters(plan.parameters, { startMessage: plan.startMessage, skillBody: plan.skill.body, scheduled: plan.trigger.kind === 'schedule' });
-    const markWorkflow = (agentDir) => setWorkflowFields(agentDir, plan.id, { title: plan.name, startMessage: plan.startMessage, trigger: plan.trigger.description, parameters });
+    // One text, as the editor shows it: the start message, then the steps.
+    const instructions = plan.skill.body.trim().startsWith(plan.startMessage.trim()) ? plan.skill.body : `${plan.startMessage.trim()}\n\n${plan.skill.body.trim()}`;
+    const markWorkflow = (agentDir) => setWorkflowFields(agentDir, plan.id, { title: plan.name, instructions, parameters });
     const agents = await deps.agentInfo();
     resolveConnections(plan, agents);
     const keys = input.mcpKeys && typeof input.mcpKeys === 'object' ? Object.fromEntries(Object.entries(input.mcpKeys).flatMap(([k, v]) => (typeof v === 'string' && v.trim() ? [[k, v.trim()]] : []))) : {};
@@ -491,11 +493,46 @@ function workflowTasks(id, tasks) {
         .filter((t) => t.workflow_id === id && t.status !== 'cancelled' && t.status !== 'done')
         .sort((a, b) => Number('every' in b.schedule) - Number('every' in a.schedule));
 }
+const WEEKDAYS = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
+const MONTHS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+/** A schedule in words, in its time zone: "every day at 18:05", "every
+ * Monday at 09:00", "every 10 minutes", "once on Nov 6 at 18:05". */
+export function plainSchedule(schedule) {
+    const zone = ('time_zone' in schedule && schedule.time_zone) || workspaceTimeZone();
+    const at = (iso) => {
+        const t = wallTimeAt(Date.parse(iso), zone);
+        return { ...t, clock: `${String(t.hour).padStart(2, '0')}:${String(t.minute).padStart(2, '0')}` };
+    };
+    if ('run_at' in schedule) {
+        if (Number.isNaN(Date.parse(schedule.run_at)))
+            return `once at ${schedule.run_at}`;
+        const t = at(schedule.run_at);
+        return `once on ${MONTHS[t.month - 1]} ${t.day} at ${t.clock}`;
+    }
+    const m = /^(\d+)([mhdw])$/.exec(schedule.every);
+    if (!m)
+        return describeSchedule(schedule);
+    const n = Number(m[1]);
+    const unit = m[2];
+    const anchor = schedule.anchor && !Number.isNaN(Date.parse(schedule.anchor)) ? at(schedule.anchor) : undefined;
+    if (unit === 'm')
+        return n === 1 ? 'every minute' : `every ${n} minutes`;
+    if (unit === 'h')
+        return (n === 1 ? 'every hour' : `every ${n} hours`) + (anchor && n === 1 ? ` at :${String(anchor.minute).padStart(2, '0')}` : '');
+    if (unit === 'd')
+        return (n === 1 ? 'every day' : `every ${n} days`) + (anchor ? ` at ${anchor.clock}` : '');
+    if (n === 1 && anchor)
+        return `every ${WEEKDAYS[anchor.weekday]} at ${anchor.clock}`;
+    return (n === 1 ? 'every week' : `every ${n} weeks`) + (anchor ? ` on ${WEEKDAYS[anchor.weekday]} at ${anchor.clock}` : '');
+}
 function scheduleView(task) {
     return {
         taskId: task.task_id,
         status: task.status,
         repeating: 'every' in task.schedule,
+        describe: plainSchedule(task.schedule),
+        ...(task.task_name ? { name: task.task_name } : {}),
+        notify: Boolean(task.notify),
         ...(task.params ? { params: task.params } : {}),
         ...(task.next_run_at ? { nextRunAt: task.next_run_at } : {}),
         ...(task.last_run_at ? { lastRunAt: task.last_run_at } : {}),
@@ -525,10 +562,12 @@ export async function listAgentWorkflows(agentName, agentDir) {
         return [];
     const tasks = await listScheduledTasks({ agent: agentName });
     const runs = await listRuns(agentName);
+    const triggers = await listTriggers(agentName);
     return workflows.map((w) => {
         const schedules = workflowTasks(w.id, tasks).map(scheduleView);
         const recentRuns = runs.filter((r) => r.workflow_id === w.id).slice(0, RECENT_RUNS);
-        return { ...w, schedules, recentRuns, ...(schedules[0] ? { schedule: schedules[0] } : {}) };
+        const webhooks = triggers.filter((t) => t.workflow_id === w.id && t.enabled).length;
+        return { ...w, schedules, recentRuns, webhooks, ...(schedules[0] ? { schedule: schedules[0] } : {}) };
     });
 }
 function sameParams(a, b) {
@@ -558,9 +597,11 @@ export async function prepareWorkflowRun(agentName, agentDir, id, rawParams) {
     }
     return { workflow, params, message: workflowRunMessage(workflow, params) };
 }
-/** Changes how a workflow's runs start, from the console's workflow
- * editor: its title, start message, trigger and parameters. Its steps
- * (the skill body) and the skill's other front matter are kept. */
+/** Changes a workflow from the console's editor: its title, its
+ * instructions (the skill body, which an older workflow's start message
+ * and label are folded into), and its parameters. The skill's other front
+ * matter is kept. A body with `start_message` (and no `instructions`) is
+ * still taken, as before. */
 export function updateWorkflow(agentDir, id, input) {
     if (!readWorkflow(agentDir, id))
         throw new WorkflowError(`No workflow ${id}.`);
@@ -573,10 +614,13 @@ export function updateWorkflow(agentDir, id, input) {
         return trimmed;
     };
     const title = text(input.title, 'The title', 120);
-    const startMessage = text(input.start_message, 'The start message', 4000);
-    if (!startMessage)
-        throw new WorkflowError('Write the start message: what each run begins with, e.g. "Check the refund request for order $order_number."');
-    const trigger = text(input.trigger, 'When it runs', 200);
+    const instructions = input.instructions === undefined ? undefined : text(input.instructions, 'The instructions', 12000);
+    if (instructions !== undefined && !instructions)
+        throw new WorkflowError('Write the instructions: what the agent does, e.g. "Check the refund request for order $order_number: look up the order, then…"');
+    const startMessage = instructions === undefined ? text(input.start_message, 'The start message', 4000) : '';
+    if (instructions === undefined && !startMessage)
+        throw new WorkflowError('Write the instructions: what the agent does each run.');
+    const trigger = instructions === undefined ? text(input.trigger, 'When it runs', 200) : '';
     const raw = input.parameters ?? {};
     if (typeof raw !== 'object' || Array.isArray(raw))
         throw new WorkflowError('parameters must be an object of names to { description, required }.');
@@ -587,7 +631,7 @@ export function updateWorkflow(agentDir, id, input) {
         const s = spec && typeof spec === 'object' ? spec : {};
         parameters[name] = { description: text(s.description, `The description of "${name}"`, 300), required: s.required === true };
     }
-    setWorkflowFields(agentDir, id, { ...(title ? { title } : {}), startMessage, ...(trigger ? { trigger } : {}), parameters });
+    setWorkflowFields(agentDir, id, instructions !== undefined ? { ...(title ? { title } : {}), instructions, parameters } : { ...(title ? { title } : {}), startMessage, ...(trigger ? { trigger } : {}), parameters });
     return readWorkflow(agentDir, id);
 }
 /** Forgets a workflow: its skill stays, as a plain skill, and the

package/dist/web/workflow-page.js

@@ -327,7 +327,7 @@ ${consoleShellScript}
 
   // ---- 3. Done ----
   function renderDone(c) {
-    var agentHref = '/agents/config?agent=' + encodeURIComponent(c.agent);
+    var agentHref = '/agents/config?agent=' + encodeURIComponent(c.agent) + '&tab=workflows';
     var items = c.checklist || [];
     page.innerHTML = '<div class="wf-card">' +
       '<h2>' + esc(c.workflow) + ' is ready</h2>' +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loopengine",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "type": "module",
   "description": "Runtime for tool-using AI agents with a transparent ReAct loop.",
   "license": "MIT",
@@ -46,6 +46,8 @@
     "dist/core/trusted-proxy.d.ts",
     "dist/core/usage.js",
     "dist/core/usage.d.ts",
+    "dist/core/run-events.js",
+    "dist/core/run-events.d.ts",
     "dist/core/email-senders.js",
     "dist/core/email-senders.d.ts",
     "dist/core/notifier-file.js",