loopengine 0.3.7 → 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,7 @@ 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; }
@@ -837,6 +838,35 @@ ${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;
@@ -874,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);
@@ -893,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>' +
@@ -960,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;
@@ -2381,7 +2415,8 @@ ${consoleShellScript}
     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>'
@@ -2455,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) {
@@ -3544,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>' +
@@ -3657,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) {

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.7",
+  "version": "0.3.8",
   "type": "module",
   "description": "Runtime for tool-using AI agents with a transparent ReAct loop.",
   "license": "MIT",