loopengine 0.3.6 → 0.3.8

package/dist/core/system-agents/workflow-planner.js

@@ -131,7 +131,10 @@ export function validateWorkflowPlan(raw) {
     if (!raw || typeof raw !== 'object')
         return undefined;
     const r = raw;
-    const name = str(r.name, 80);
+    // A name for people: one written as an id ("daily-hn-digest") becomes
+    // words ("Daily hn digest").
+    const rawName = str(r.name, 80);
+    const name = rawName && /^[a-z0-9]+(-[a-z0-9]+)+$/.test(rawName) ? rawName.charAt(0).toUpperCase() + rawName.slice(1).replace(/-/g, ' ') : rawName;
     const summary = str(r.summary, 600);
     const skillRaw = (r.skill ?? {});
     const skillBody = str(skillRaw.body, 12000);

package/dist/core/workflows.d.ts

@@ -26,6 +26,9 @@ export interface Workflow {
  * `startMessage` (from before) is kept for workflows saved that way. */
 export interface WorkflowFields {
     title?: string;
+    /** The skill's one-line description: what the job is, which chat
+     * matches requests against. Kept as it is when not given. */
+    description?: string;
     instructions?: string;
     startMessage?: string;
     trigger?: string;

package/dist/core/workflows.js

@@ -97,7 +97,8 @@ function workflowFrom(id, frontmatter, body) {
         return undefined;
     return {
         id,
-        title: typeof frontmatter.title === 'string' && frontmatter.title.trim() ? frontmatter.title.trim() : titleFromId(id),
+        // A title that's just the id (a plan once saved it that way) reads as words.
+        title: typeof frontmatter.title === 'string' && frontmatter.title.trim() && frontmatter.title.trim() !== id ? frontmatter.title.trim() : titleFromId(id),
         description: typeof frontmatter.description === 'string' ? frontmatter.description : '',
         startMessage,
         trigger: typeof frontmatter.trigger === 'string' && frontmatter.trigger.trim() ? frontmatter.trigger.trim() : 'When asked',
@@ -141,6 +142,8 @@ export function setWorkflowFields(agentDir, id, fields) {
     const frontmatter = { ...skill.frontmatter };
     for (const key of WORKFLOW_KEYS)
         delete frontmatter[key];
+    if (fields.description)
+        frontmatter.description = fields.description;
     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);

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

@@ -49,6 +49,8 @@ export const agentsConfigPageHtml = `<!doctype html>
   form.add-source .schedule-when input[type="number"] { width: 80px; }
   form.add-source .schedule-when select, form.add-source .schedule-when input[type="datetime-local"] { width: auto; }
   .workflow-card { margin-bottom: 10px; }
+  .workflow-card.workflow-focus { box-shadow: 0 0 0 2px var(--le-accent, #0f766e); transition: box-shadow 0.3s; }
+  tr.schedule-focus td { background: var(--le-accent-soft, #e6f4ef); transition: background 0.3s; }
   .workflow-starts { margin: 10px 0 0; padding: 10px 12px; border: 1px solid var(--le-line, #e5e7eb); border-radius: 8px; background: var(--le-surface, #f6f7f9); }
   .workflow-starts h4 { margin: 0; font-size: 13.5px; font-weight: 600; }
   .wf-start { padding: 10px 0; border-top: 1px solid var(--le-line, #e5e7eb); display: grid; gap: 6px; font-size: 13px; }
@@ -709,7 +711,7 @@ ${consoleShellScript}
     return text.charAt(0).toUpperCase() + text.slice(1);
   }
 
-  // How it starts: four ways, each with a ? that says what it is. A
+  // Ways to run it: four, each with a ? that says what it is. A
   // schedule (pause, resume, remove, add), a webhook, Run now with the
   // values a run is given, and the API call an app makes.
   function wfStartSection(key, title, help, body) {
@@ -722,14 +724,15 @@ ${consoleShellScript}
   function workflowStartsHtml(w, agentName, paramsHtml) {
     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 === 'paused' ? '<span class="le-pill warn">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 +
+        '<span><a href="?agent=' + encodeURIComponent(agentName) + '&amp;tab=schedules#schedule-' + escapeHtml(x.taskId) + '" class="workflow-schedule-link" data-task="' + escapeHtml(x.taskId) + '" title="See it in the Schedules tab">' +
+          escapeHtml(x.describe.charAt(0).toUpperCase() + x.describe.slice(1)) + '</a></span>' + state +
         (values ? '<span class="hint">' + values + '</span>' : '') +
-        (x.notify ? '<span class="hint">sends you each result</span>' : '') +
+        (x.notify ? '<span class="hint">results go to your messaging app</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>' : '') +
@@ -737,11 +740,11 @@ ${consoleShellScript}
         '</span></li>';
     }).join('');
     var paramNames = Object.keys(w.parameters || {});
-    var example = paramNames.length
-      ? '{ "params": { ' + paramNames.map(function (p) { return '"' + p + '": "' + String.fromCharCode(8230) + '"'; }).join(', ') + ' } }'
-      : '{}';
+    // A body that shows what a call can carry: its values, and waiting
+    // for the result.
+    var example = '{ ' + (paramNames.length ? '"params": { ' + paramNames.map(function (p) { return '"' + p + '": "' + String.fromCharCode(8230) + '"'; }).join(', ') + ' }, ' : '') + '"wait": true }';
     var apiUrl = location.origin + '/agents/' + encodeURIComponent(agentName) + '/workflows/' + encodeURIComponent(w.id) + '/run';
-    return '<div class="workflow-starts"><h4>How it starts</h4>' +
+    return '<div class="workflow-starts"><h4>Ways to run it</h4>' +
       wfStartSection('schedule-' + w.id, 'Schedule',
         'Runs it on a timer, like every day at 9:00, with the values you give the schedule. Nobody needs to be there: approvals and questions go to the agent' + String.fromCharCode(8217) + 's messaging app.',
         (schedules ? '<ul class="schedule-history">' + schedules + '</ul>' : '<span class="hint">None yet.</span>') +
@@ -756,7 +759,9 @@ ${consoleShellScript}
         '<div><button type="button" class="workflow-run primary">Run now</button></div>') +
       wfStartSection('api-' + w.id, 'API',
         'Your own app starts a run by calling this address with an API key. Add "wait": true to get the result in the answer, or "callback_url" to have it posted to you when the run ends.',
-        '<pre>POST ' + escapeHtml(apiUrl) + String.fromCharCode(10) + escapeHtml(example) + '</pre>') +
+        '<pre>POST ' + escapeHtml(apiUrl) + String.fromCharCode(10) + escapeHtml(example) + '</pre>' +
+        '<p class="hint" style="margin:0">' + (paramNames.length ? '<code>params</code>: ' + paramNames.map(function (p) { return '<code>' + escapeHtml(p) + '</code>' + (w.parameters[p].required ? ' (required)' : '') + (w.parameters[p].description ? ', ' + escapeHtml(w.parameters[p].description) : ''); }).join('; ') + '. ' : 'It takes no params. ') +
+          'Optional: <code>"wait": true</code> answers with the result; <code>"notify": true</code> sends it through the agent' + String.fromCharCode(8217) + 's messaging app; <code>"callback_url"</code> posts it to your app when the run ends. Leave them out to get the run' + String.fromCharCode(8217) + 's id back at once.</p>') +
     '</div>';
   }
 
@@ -771,7 +776,7 @@ ${consoleShellScript}
         : s.waiting
           ? '<span class="le-pill ask">Waiting for a decision</span>'
           : s.status === 'paused'
-            ? '<span class="le-pill">Schedule paused</span>'
+            ? '<span class="le-pill warn">Schedule paused</span>'
             : s.status === 'running'
               ? '<span class="le-pill accent">Running</span>'
               : '<span class="le-pill good">On</span>' + (s.nextRunAt ? ' <span class="hint">next ' + escapeHtml(new Date(s.nextRunAt).toLocaleString()) + '</span>' : '');
@@ -833,6 +838,53 @@ ${consoleShellScript}
   var workflowsRefreshTimer = null;
   // Set by a workflow's "Add a schedule", for the Schedules tab's form.
   var pendingScheduleWorkflow = null;
+  // Set by a schedule's workflow link: the card to scroll to and mark.
+  var pendingWorkflowFocus = null;
+
+  function focusWorkflowCard(tries) {
+    if (!pendingWorkflowFocus) return;
+    var card = detail.querySelector('.workflow-card[data-workflow="' + CSS.escape(pendingWorkflowFocus) + '"]');
+    if (!card) {
+      if ((tries || 0) < 40) setTimeout(function () { focusWorkflowCard((tries || 0) + 1); }, 150);
+      return;
+    }
+    pendingWorkflowFocus = null;
+    card.scrollIntoView({ block: 'start' });
+    card.classList.add('workflow-focus');
+    setTimeout(function () { card.classList.remove('workflow-focus'); }, 2500);
+  }
+
+  // Set by a workflow's Edit on the Skills list: the workflow to open in
+  // its editor once the Workflows tab has drawn it.
+  var pendingWorkflowEdit = null;
+
+  function openPendingWorkflowEdit() {
+    if (!pendingWorkflowEdit) return;
+    var card = detail.querySelector('.workflow-card[data-workflow="' + CSS.escape(pendingWorkflowEdit) + '"]');
+    if (!card) return;
+    pendingWorkflowEdit = null;
+    openWorkflowEditor(currentName, card);
+    card.scrollIntoView({ block: 'start' });
+  }
+
+  // Set by a schedule on a workflow card (or a #schedule-<id> link): the
+  // Schedules tab's row to show.
+  var pendingScheduleFocus = /^#schedule-/.test(location.hash) ? location.hash.slice('#schedule-'.length) : null;
+
+  // Scrolls to that row and marks it for a moment, once the tab has drawn
+  // it (it may still be loading).
+  function focusScheduleRow(tries) {
+    if (!pendingScheduleFocus) return;
+    var row = detail.querySelector('#schedule-' + CSS.escape(pendingScheduleFocus));
+    if (!row) {
+      if ((tries || 0) < 40) setTimeout(function () { focusScheduleRow((tries || 0) + 1); }, 150);
+      return;
+    }
+    pendingScheduleFocus = null;
+    row.scrollIntoView({ block: 'center' });
+    row.classList.add('schedule-focus');
+    setTimeout(function () { row.classList.remove('schedule-focus'); }, 2500);
+  }
   var workflowsById = {};
   // Set while a workflow's editor is open, so the running-run refresh
   // doesn't redraw the card under someone typing.
@@ -852,6 +904,7 @@ ${consoleShellScript}
       el.innerHTML = renderWorkflowsHtml(name, workflows);
       var cards = el.querySelectorAll('.workflow-card');
       for (var i = 0; i < cards.length; i++) wireWorkflowCard(name, cards[i]);
+      openPendingWorkflowEdit();
       // 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 === 'workflows') workflowsRefreshTimer = setTimeout(function () { if (!workflowEditing) loadWorkflowsSection(name); }, 3000);
@@ -871,7 +924,10 @@ ${consoleShellScript}
   function workflowEditorHtml(w) {
     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>Title<input name="title" maxlength="120" value="' + escapeHtml(w.title) + '">' +
+        '<span class="hint">ID: <code>' + escapeHtml(w.id) + '</code>, used by the API, schedules and webhooks; it doesn' + String.fromCharCode(8217) + 't change when you edit.</span></label>' +
+      '<label>Description <span class="hint">(one line on what this job is; the agent uses it to recognise the job when you ask in Chat)</span>' +
+        '<input name="description" maxlength="500" required value="' + escapeHtml(w.description) + '"></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>' +
@@ -938,7 +994,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, instructions: form.instructions.value, parameters: parameters }),
+        body: JSON.stringify({ title: form.title.value, description: form.description.value, instructions: form.instructions.value, parameters: parameters }),
       }).then(function (r) {
         if (!r.ok) { result.textContent = r.body.error || 'Could not save'; return; }
         workflowEditing = false;
@@ -1134,6 +1190,17 @@ ${consoleShellScript}
     var result = card.querySelector('.workflow-result');
     var base = '/agents/' + encodeURIComponent(name) + '/workflows/' + encodeURIComponent(id);
     card.querySelector('.workflow-edit').addEventListener('click', function () { openWorkflowEditor(name, card); });
+    // A schedule opens its own row in the Schedules tab.
+    var scheduleLinks = card.querySelectorAll('.workflow-schedule-link');
+    for (var sl = 0; sl < scheduleLinks.length; sl++) {
+      scheduleLinks[sl].addEventListener('click', function (ev) {
+        if (ev.metaKey || ev.ctrlKey || ev.shiftKey) return;
+        ev.preventDefault();
+        pendingScheduleFocus = ev.currentTarget.dataset.task;
+        switchTab('schedules');
+        focusScheduleRow();
+      });
+    }
     // The ? beside each way it starts shows or hides what it is.
     var helps = card.querySelectorAll('.help-q');
     for (var hq = 0; hq < helps.length; hq++) {
@@ -2345,10 +2412,11 @@ ${consoleShellScript}
       return '<li><span class="le-pill ' + (h.status === 'ok' ? 'good' : 'bad') + '">' + escapeHtml(h.status) + '</span> <span class="hint">' + escapeHtml(fmtScheduleTime(h.ran_at)) + '</span>' +
         '<div class="schedule-result">' + escapeHtml(h.status === 'ok' ? (h.result || '') : (h.error || '')) + '</div></li>';
     }).join('');
-    return '<tr>' +
+    return '<tr id="schedule-' + escapeHtml(t.task_id) + '">' +
       '<td style="min-width:180px"><strong>' + escapeHtml(t.task_name || 'Untitled') + '</strong>' +
         (t.workflow
-          ? '<div><span class="le-pill accent">Workflow</span> ' + escapeHtml(t.workflow.title) + '</div><div class="schedule-result hint">' + escapeHtml(t.workflow.start_message) +
+          ? '<div><span class="le-pill accent">Workflow</span> <a href="?agent=' + encodeURIComponent(currentName) + '&amp;tab=workflows" class="schedule-workflow-link" data-workflow="' + escapeHtml(t.workflow.id) + '" title="See it on the Workflows tab">' + escapeHtml(t.workflow.title) + '</a></div>' +
+            '<div class="schedule-result hint">' + escapeHtml(t.workflow.description || t.workflow.start_message) +
               (t.params ? '<br>' + Object.keys(t.params).map(function (k) { return escapeHtml(k) + ': ' + escapeHtml(t.params[k]); }).join(' ' + String.fromCharCode(183) + ' ') : '') + '</div>'
           : t.workflow_missing
             ? '<div><span class="le-pill bad">Workflow removed</span> <span class="hint">' + escapeHtml(t.workflow_id) + '</span></div>'
@@ -2381,7 +2449,7 @@ ${consoleShellScript}
                     return '<option value="' + escapeHtml(w.id) + '">' + escapeHtml(w.title) + '</option>';
                   }).join('') + '</select></div>' +
                 '<div class="workflow-params" id="scheduleParams" style="margin:0 0 4px 22px"></div>' +
-                '<p class="hint" style="margin:0 0 4px 22px">Each run starts with the workflow&#39;s start message as it is then, so changing the workflow changes what runs.</p>' +
+                '<p class="hint" style="margin:0 0 4px 22px">Each run follows the workflow&#39;s instructions as they are then, so changing the workflow changes what runs.</p>' +
                 '<div class="schedule-when"><input type="radio" name="runs" value="message" id="runsMessage"><label for="runsMessage">A message</label></div>' +
               '</div>'
             : '') +
@@ -2422,6 +2490,17 @@ ${consoleShellScript}
   function wireSchedulesHandlers(name) {
     var content = schedulesContentEl();
     if (!content) return;
+    // A schedule's workflow opens its card on the Workflows tab.
+    var workflowLinks = content.querySelectorAll('.schedule-workflow-link');
+    for (var wl = 0; wl < workflowLinks.length; wl++) {
+      workflowLinks[wl].addEventListener('click', function (ev) {
+        if (ev.metaKey || ev.ctrlKey || ev.shiftKey) return;
+        ev.preventDefault();
+        pendingWorkflowFocus = ev.currentTarget.dataset.workflow;
+        switchTab('workflows');
+        focusWorkflowCard();
+      });
+    }
     var actionBtns = content.querySelectorAll('.schedule-action');
     for (var i = 0; i < actionBtns.length; i++) {
       actionBtns[i].addEventListener('click', function (ev) {
@@ -2480,6 +2559,7 @@ ${consoleShellScript}
       form.scrollIntoView({ block: 'start' });
     }
     pendingScheduleWorkflow = null;
+    focusScheduleRow();
     renderScheduleParams();
     if (workflowSelect) workflowSelect.addEventListener('change', renderScheduleParams);
     for (var k = 0; k < runsRadios.length; k++) {
@@ -3510,12 +3590,17 @@ ${consoleShellScript}
   // needs a further per-skill GET, to pull the body that index doesn't
   // carry. ----
 
+  // A skill that's a workflow is labelled, and its Edit opens the workflow
+  // editor: its instructions are one text there, with its title,
+  // description and parameters.
   function renderSkillCard(s) {
     return '<div class="source">' +
       '<div class="source-head">' +
-        '<h4>' + escapeHtml(s.name) + '</h4>' +
+        '<h4>' + escapeHtml(s.name) + (s.workflow ? ' <span class="le-pill accent">Workflow</span>' : '') + '</h4>' +
         '<span>' +
-          '<button type="button" class="edit-skill-btn" data-id="' + escapeHtml(s.name) + '">Edit</button> ' +
+          (s.workflow
+            ? '<button type="button" class="edit-workflow-skill-btn" data-id="' + escapeHtml(s.name) + '" title="Edit it as a workflow, on the Workflows tab">Edit</button> '
+            : '<button type="button" class="edit-skill-btn" data-id="' + escapeHtml(s.name) + '">Edit</button> ') +
           '<button type="button" class="delete-btn delete-skill-btn" data-id="' + escapeHtml(s.name) + '" title="Delete this skill" aria-label="Delete this skill">Delete</button>' +
         '</span>' +
       '</div>' +
@@ -3623,6 +3708,15 @@ ${consoleShellScript}
       });
     }
 
+    var workflowEditButtons = panel.querySelectorAll('.edit-workflow-skill-btn');
+    for (var we = 0; we < workflowEditButtons.length; we++) {
+      workflowEditButtons[we].addEventListener('click', function (ev) {
+        pendingWorkflowEdit = ev.currentTarget.getAttribute('data-id');
+        switchTab('workflows');
+        openPendingWorkflowEdit();
+      });
+    }
+
     var editButtons = panel.querySelectorAll('.edit-skill-btn');
     for (var i = 0; i < editButtons.length; i++) {
       editButtons[i].addEventListener('click', function (ev) {
@@ -4413,7 +4507,7 @@ ${consoleShellScript}
       '<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>' +
+        '<p class="muted" style="margin:0 0 20px">The jobs this agent does on its own: what it does, the ways to run it (a schedule, a webhook, 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

package/dist/web/workflow-admin.js

@@ -614,6 +614,9 @@ export function updateWorkflow(agentDir, id, input) {
         return trimmed;
     };
     const title = text(input.title, 'The title', 120);
+    const description = input.description === undefined ? undefined : text(input.description, 'The description', 500);
+    if (description !== undefined && !description)
+        throw new WorkflowError('Write a one-line description: what this job is, e.g. "Daily digest of AI-agent stories on Hacker News". The agent uses it to recognise the job in Chat.');
     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…"');
@@ -631,7 +634,8 @@ 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, instructions !== undefined ? { ...(title ? { title } : {}), instructions, parameters } : { ...(title ? { title } : {}), startMessage, ...(trigger ? { trigger } : {}), parameters });
+    const named = { ...(title ? { title } : {}), ...(description ? { description: description.replace(/\s+/g, ' ') } : {}) };
+    setWorkflowFields(agentDir, id, instructions !== undefined ? { ...named, instructions, parameters } : { ...named, startMessage, ...(trigger ? { trigger } : {}), parameters });
     return readWorkflow(agentDir, id);
 }
 /** Removes a workflow: its skill stays, as a plain skill the agent can

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loopengine",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "type": "module",
   "description": "Runtime for tool-using AI agents with a transparent ReAct loop.",
   "license": "MIT",