@goodandready/dsh-cron 0.2.5 → 0.2.6

package/lib/client.js

@@ -36,6 +36,7 @@ window.__ModuleLoader__.load({
     const ICON_EDIT = '<svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7"></path><path d="M18.5 2.5a2.121 2.121 0 0 1 3 3L12 15l-4 1 1-4 9.5-9.5z"></path></svg>';
     const ICON_SEND = '<svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><line x1="22" y1="2" x2="11" y2="13"></line><polygon points="22 2 15 22 11 13 2 9 22 2"></polygon></svg>';
     const ICON_COPY = '<svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path></svg>';
+    const ICON_TUNE = '<svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><line x1="4" y1="21" x2="4" y2="14"></line><line x1="4" y1="10" x2="4" y2="3"></line><line x1="12" y1="21" x2="12" y2="12"></line><line x1="12" y1="8" x2="12" y2="3"></line><line x1="20" y1="21" x2="20" y2="16"></line><line x1="20" y1="12" x2="20" y2="3"></line><line x1="1" y1="14" x2="7" y2="14"></line><line x1="9" y1="8" x2="15" y2="8"></line><line x1="17" y1="16" x2="23" y2="16"></line></svg>';
     const ICON_DOWNLOAD = '<svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"></path><polyline points="7 10 12 15 17 10"></polyline><line x1="12" y1="15" x2="12" y2="3"></line></svg>';
     const ICON_UPLOAD = '<svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"></path><polyline points="17 8 12 3 7 8"></polyline><line x1="12" y1="3" x2="12" y2="15"></line></svg>';
     const ICON_TELEGRAM = '<svg viewBox="0 0 24 24" width="16" height="16" fill="currentColor" aria-hidden="true"><path d="M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm4.64 6.8-1.7 8.01c-.13.58-.47.72-.95.45l-2.6-1.92-1.25 1.21c-.14.14-.26.26-.53.26l.19-2.64 4.81-4.35c.21-.19-.05-.29-.32-.11L8.34 13.5 5.78 12.7c-.56-.17-.57-.56.12-.83l10-3.86c.46-.17.87.11.74.79z"/></svg>';
@@ -60,6 +61,8 @@ window.__ModuleLoader__.load({
         'actions.runNowShort': 'Run',
         'actions.edit': 'Edit / Details',
         'actions.duplicate': 'Duplicate task',
+        'actions.tuneWithDsh': 'Tune with DSH',
+        'tune.startFailed': 'Could not start the tuning dialogue: {error}',
         'actions.delete': 'Delete task',
         'duplicate.done': 'Copy created and paused: review its schedule before resuming it.',
         'duplicate.oneShotHint': 'The copy is one-shot and paused — its original time has likely passed, so set a new time before resuming.',
@@ -107,6 +110,7 @@ window.__ModuleLoader__.load({
         'list.oneShot': 'One-shot',
         'list.next': ' · next: {time}',
         'recs.title': 'Recommended tasks',
+        'recs.hint': 'Ready-to-use recipes. Clicking one opens the form with its fields filled in — nothing is created until you save.',
         'modal.editTitle': 'Edit task',
         'modal.newTitle': 'New scheduled task',
         'modal.statusActive': '● Active',
@@ -170,6 +174,18 @@ window.__ModuleLoader__.load({
         'form.providerDefault': 'Default (DSH)',
         'form.modelLabel': 'LLM model',
         'form.modelDefault': 'Default',
+        'form.silentRuleLabel': 'Silent rule (optional)',
+        'form.silentRulePlaceholder': 'Stay silent when no filesystem is above 80%',
+        'form.silentRuleHint': 'For tasks with output: a cheap model judges the run against this rule and the report is skipped when it says to stay silent. If the model is unavailable or unsure, the report is delivered.',
+        'history.silentSkip': 'stayed silent:',
+        'history.diagnosis': 'Diagnosis',
+        'history.applySuggestion': 'Open the edit form with this suggestion',
+        'form.inspectOnFailureLabel': 'Diagnose failures with a model',
+        'form.inspectOnFailureHint': 'After a failed run a model reads the prompt, the error and the output, and the diagnosis with a proposed prompt change is stored with the run. Nothing is applied automatically.',
+        'settings.inspectorModelLabel': 'Model for failure diagnosis',
+        'form.fallbackModelLabel': 'Fallback model (optional)',
+        'form.fallbackModelPlaceholder': 'e.g. deepseek-reasoner',
+        'form.fallbackModelHint': 'If the run fails on the model above, it is retried once on this model. Both attempts are counted in the cost.',
         'form.promptLabelScript': 'Shell command or script',
         'form.promptLabelLlm': 'Instruction / Prompt for the agent',
         'form.promptPlaceholderScript': 'curl -fsSL https://... || exit 1',
@@ -195,7 +211,7 @@ window.__ModuleLoader__.load({
         'form.channelsHint': 'Pick the channels for this task. An explicit selection overrides the Telegram switch above; leave everything unchecked to fall back to it.',
         'form.templateLabel': 'Message template (optional)',
         'form.templatePlaceholder': '⏰ {title} — {status} in {duration}',
-        'form.templateHint': 'Variables: {title} {id} {status} {output} {error} {duration} {schedule} {time} {tokens} {cost}. Empty = built-in text.',
+        'form.templateHint': 'Variables: {title} {id} {status} {output} {error} {duration} {schedule} {time} {tokens} {cost} {model}. Empty = built-in text.',
         'form.channelTelegram': 'Telegram',
         'form.channelKanban': 'dsh-kanban card',
         'form.channelDiscord': 'Discord',
@@ -229,6 +245,9 @@ window.__ModuleLoader__.load({
         'settings.templateLabel': 'Default message template',
         'settings.templateHint': 'Applies to every channel without its own template. Empty = built-in text.',
         'settings.deliveryTimeoutMsLabel': 'Delivery timeout per channel (ms)',
+        'settings.automationSection': 'Automation models',
+        'settings.automationHint': 'Models used for the small helper calls (rule evaluation, failure analysis). Leave empty to use the task model.',
+        'settings.silentRuleModelLabel': 'Model for silent rules',
         'settings.secretsOnCard': 'Credentials referenced from the settings panel are shown masked and stored by name.',
         'form.nextRunLabel': 'Next run: ',
         'form.notScheduled': 'not scheduled',
@@ -365,6 +384,8 @@ window.__ModuleLoader__.load({
       { key: 'giteaBaseUrl', labelKey: 'settings.giteaBaseUrlLabel', group: 'channels' },
       { key: 'giteaRepo', labelKey: 'settings.giteaRepoLabel', group: 'channels' },
       { key: 'deliveryTimeoutMs', labelKey: 'settings.deliveryTimeoutMsLabel', group: 'channels', numeric: true, defaultValue: 15000, min: 1000 },
+      { key: 'silentRuleModel', labelKey: 'settings.silentRuleModelLabel', group: 'automation' },
+      { key: 'inspectorModel', labelKey: 'settings.inspectorModelLabel', group: 'automation' },
     ];
     const DELIVERY_SETTING_KEYS = DELIVERY_SETTING_FIELDS.map((f) => f.key);
     // The global template plus the per-channel override map (server model).
@@ -436,6 +457,12 @@ window.__ModuleLoader__.load({
             ...DELIVERY_SETTING_FIELDS.filter((f) => f.group === 'channels').map(field)
           ),
         ]),
+        section('automation', 'settings.automationSection', [
+          React.createElement('div', { className: 'dsh-cron-hint', key: 'hint', style: { marginBottom: '10px' } }, T('settings.automationHint')),
+          React.createElement('div', { className: 'dsh-cron-form-row', key: 'row' },
+            ...DELIVERY_SETTING_FIELDS.filter((f) => f.group === 'automation').map(field)
+          ),
+        ]),
         section('templates', 'settings.templatesSection', [
           React.createElement('div', { className: 'dsh-cron-form-group', key: 'global', style: { marginBottom: '10px' } },
             React.createElement('label', null, T('settings.templateLabel')),
@@ -815,6 +842,9 @@ window.__ModuleLoader__.load({
       const [formPrompt, setFormPrompt] = React.useState('');
       const [formProvider, setFormProvider] = React.useState('');
       const [formModel, setFormModel] = React.useState('');
+      const [formFallbackModel, setFormFallbackModel] = React.useState('');
+      const [formSilentRule, setFormSilentRule] = React.useState('');
+      const [formInspectOnFailure, setFormInspectOnFailure] = React.useState(false);
       const [formDelivery, setFormDelivery] = React.useState('isolated');
       const [selectedTaskMeta, setSelectedTaskMeta] = React.useState(null);
       const [modalTab, setModalTab] = React.useState('params');
@@ -1138,6 +1168,40 @@ window.__ModuleLoader__.load({
         }
       };
 
+      /** #49: tune an existing task in a dialogue instead of editing fields. */
+      const handleTuneWithDsh = async (task) => {
+        const lines = [
+          `Tune the existing scheduled task "${task.title}" (id: ${task.id}).`,
+          'Its current configuration is:',
+          `- type: ${task.type || 'llm'}`,
+          `- schedule: ${task.scheduleText || task.schedule} (${task.schedule})`,
+          `- status: ${task.status}`,
+          task.model ? `- model: ${task.model}${task.fallbackModel ? `, fallback: ${task.fallbackModel}` : ''}` : null,
+          Array.isArray(task.channels) && task.channels.length ? `- channels: ${task.channels.join(', ')}` : null,
+          `- prompt: ${String(task.prompt || '').slice(0, 400)}`,
+          '',
+          'Ask what should change, then apply it with the cron_update_task tool (read the current state again with cron_get_task if you need the full configuration).',
+          'If the change makes the task execute code (script/node/python/ssh/docker), confirm it with me explicitly before applying it.',
+        ].filter(Boolean);
+        try {
+          const res = await fetch('/dsh-cron/chat/start', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ prompt: lines.join(String.fromCharCode(10)) })
+          });
+          const data = await res.json();
+          if (!data.ok || !data.sessionId) {
+            alert(T_KEY(t, 'tune.startFailed', { error: (data && data.error) || '' }));
+            return;
+          }
+          if (onClose) onClose();
+          else toggle.set(false);
+          await openSession(ctx, data.sessionId);
+        } catch (err) {
+          alert(T_KEY(t, 'tune.startFailed', { error: err.message }));
+        }
+      };
+
       const handleDelete = async (id) => {
         if (!confirm(T_KEY(t, 'confirm.delete'))) return;
         try {
@@ -1272,10 +1336,21 @@ window.__ModuleLoader__.load({
         setFormPythonPath('');
         setFormSkillName('');
         setFormWorkflowName('');
+        // Reset before the preset branch, so a recipe keeps what it sets.
+        setFormFallbackModel('');
+        setFormSilentRule('');
+        setFormInspectOnFailure(false);
         if (preset) {
           setFormTitle(preset.title || '');
           setFormSchedule(preset.schedule || '');
           setFormPrompt(preset.prompt || '');
+          // #48: a recipe preset also carries its runtime and delivery shape.
+          if (preset.type) setFormType(preset.type);
+          if (Array.isArray(preset.channels) && preset.channels.length) setFormChannels(preset.channels.filter((c) => DELIVERY_CHANNELS.includes(c)));
+          if (preset.silentRule !== undefined) setFormSilentRule(preset.silentRule || '');
+          if (preset.fallbackModel !== undefined) setFormFallbackModel(preset.fallbackModel || '');
+          if (preset.inspectOnFailure !== undefined) setFormInspectOnFailure(Boolean(preset.inspectOnFailure));
+          setFormOnlyOnFailure(Boolean(preset.onlyOnFailure));
           setFormProvider(defaultModelInfo?.provider || '');
           setFormModel(defaultModelInfo?.model || '');
           if (defaultModelInfo?.provider) loadModels(defaultModelInfo.provider);
@@ -1305,7 +1380,7 @@ window.__ModuleLoader__.load({
         }
       };
 
-      const openEditModal = (task) => {
+      const openEditModal = (task, overrides = {}) => {
         setDropdownOpen(false);
         setFormId(task.id);
         setSelectedTaskMeta(task);
@@ -1313,9 +1388,12 @@ window.__ModuleLoader__.load({
         setFormTitle(task.title || '');
         setFormSchedule(task.schedule || '');
         setFormType(task.type || 'llm');
-        setFormPrompt(task.prompt || '');
+        setFormPrompt(overrides.prompt !== undefined ? overrides.prompt : (task.prompt || ''));
         setFormProvider(task.provider || '');
         setFormModel(task.model || '');
+        setFormFallbackModel(task.fallbackModel || '');
+        setFormSilentRule(task.silentRule || '');
+        setFormInspectOnFailure(Boolean(task.inspectOnFailure));
         setFormDelivery(task.delivery || 'isolated');
         setFormNotifyTelegram(Boolean(task.notifyTelegram));
         setFormChannels(Array.isArray(task.channels) ? task.channels.filter((c) => DELIVERY_CHANNELS.includes(c)) : []);
@@ -1372,6 +1450,9 @@ window.__ModuleLoader__.load({
             delivery: formDelivery || 'isolated',
             provider: isAgentType ? (formProvider || undefined) : undefined,
             model: isAgentType ? (formModel || undefined) : undefined,
+            fallbackModel: isAgentType ? (formFallbackModel.trim() || undefined) : undefined,
+            silentRule: isAgentType ? undefined : formSilentRule.trim(),
+            inspectOnFailure: isAgentType ? Boolean(formInspectOnFailure) : false,
             notifyTelegram: formNotifyTelegram,
             channels: formChannels,
             template: formTemplate.trim(),
@@ -1715,6 +1796,13 @@ window.__ModuleLoader__.load({
                         'aria-label': T_KEY(t, 'actions.edit'),
                         onClick: () => openEditModal(task)
                       }, React.createElement('span', svgProps(ICON_EDIT))),
+                      React.createElement('button', {
+                        type: 'button',
+                        className: 'dsh-cron-icon-btn',
+                        title: T_KEY(t, 'actions.tuneWithDsh'),
+                        'aria-label': T_KEY(t, 'actions.tuneWithDsh'),
+                        onClick: () => handleTuneWithDsh(task)
+                      }, React.createElement('span', svgProps(ICON_TUNE))),
                       React.createElement('button', {
                         type: 'button',
                         className: 'dsh-cron-icon-btn',
@@ -1734,6 +1822,7 @@ window.__ModuleLoader__.load({
                 )
           ),
           React.createElement('div', { className: 'dsh-cron-recs-title' }, T_KEY(t, 'recs.title')),
+          React.createElement('div', { className: 'dsh-cron-hint', style: { marginBottom: '8px' } }, T_KEY(t, 'recs.hint')),
           React.createElement('div', { className: 'dsh-cron-recs-list' },
             recs.map((rec) =>
               React.createElement('div', {
@@ -1820,6 +1909,35 @@ window.__ModuleLoader__.load({
                           React.createElement('span', { style: { color: 'var(--dsw-alias-label-tertiary, #888)', fontSize: '11.5px' } }, (run.durationMs || 0) + ' ms')
                         )
                       ),
+                      // #43: a diagnosed failure shows what went wrong and
+                      // offers to prefill the prompt with the suggestion.
+                      run.diagnosis && React.createElement('div', {
+                        className: 'dsh-cron-status-banner',
+                        'data-type': 'info',
+                        style: { marginTop: '8px', display: 'flex', flexDirection: 'column', gap: '6px' }
+                      },
+                        React.createElement('div', null,
+                          React.createElement('strong', null, T_KEY(t, 'history.diagnosis')),
+                          run.confidence ? ` (${run.confidence})` : ''
+                        ),
+                        React.createElement('div', null, run.diagnosis),
+                        run.suggestion && React.createElement('div', null,
+                          React.createElement('button', {
+                            type: 'button',
+                            className: 'dsh-cron-btn-secondary',
+                            style: { padding: '2px 8px', fontSize: '12px' },
+                            onClick: () => openEditModal(selectedTaskMeta, { prompt: run.suggestion })
+                          }, T_KEY(t, 'history.applySuggestion'))
+                        )
+                      ),
+                      // #44: a run suppressed by its silent rule says why.
+                      run.silentSkip && React.createElement('div', {
+                        className: 'dsh-cron-hint',
+                        style: { display: 'flex', gap: '6px', alignItems: 'center' }
+                      },
+                        React.createElement('span', { className: 'dsh-cron-badge-ref' }, T_KEY(t, 'history.silentSkip')),
+                        React.createElement('span', null, run.silentReason || '')
+                      ),
                       run.output && React.createElement('div', { className: 'dsh-cron-history-output' }, run.output),
                       run.error && React.createElement('div', { className: 'dsh-cron-history-output', style: { color: 'var(--dsh-cron-danger)', borderColor: 'var(--dsh-cron-danger-bg)' } }, run.error),
                       run.sessionId && React.createElement('button', {
@@ -1982,7 +2100,28 @@ window.__ModuleLoader__.load({
                       React.createElement('option', { value: '' }, T_KEY(t, 'form.modelDefault')),
                       models.map((m) => React.createElement('option', { key: m.id, value: m.id }, m.name || m.id))
                     )
-                  )
+                  ),
+                  // #45: one retry on a stronger model when the cheap one fails.
+                  React.createElement('div', { className: 'dsh-cron-form-group' },
+                    React.createElement('label', null, T_KEY(t, 'form.fallbackModelLabel')),
+                    React.createElement('input', {
+                      type: 'text',
+                      value: formFallbackModel,
+                      placeholder: T_KEY(t, 'form.fallbackModelPlaceholder'),
+                      onChange: (e) => setFormFallbackModel(e.target.value)
+                    }),
+                    React.createElement('div', { className: 'dsh-cron-hint' }, T_KEY(t, 'form.fallbackModelHint'))
+                  ),
+                  // #43: diagnose failures with a model.
+                  React.createElement('label', { className: 'dsh-cron-checkbox-row', style: { marginTop: '4px' } },
+                    React.createElement('input', {
+                      type: 'checkbox',
+                      checked: formInspectOnFailure,
+                      onChange: (e) => setFormInspectOnFailure(e.target.checked)
+                    }),
+                    React.createElement('span', null, T_KEY(t, 'form.inspectOnFailureLabel'))
+                  ),
+                  formInspectOnFailure && React.createElement('div', { className: 'dsh-cron-hint' }, T_KEY(t, 'form.inspectOnFailureHint'))
                 ),
                 formType === 'http' && React.createElement('div', { className: 'dsh-cron-form-row' },
                   React.createElement('div', { className: 'dsh-cron-form-group' },
@@ -2204,6 +2343,17 @@ window.__ModuleLoader__.load({
                       onChange: (e) => setFormTemplate(e.target.value)
                     }),
                     React.createElement('div', { className: 'dsh-cron-hint' }, T_KEY(t, 'form.templateHint'))
+                  ),
+                  // #44: output-producing runtimes may stay silent by rule.
+                  !AGENT_FORM_TYPES.includes(formType) && React.createElement('div', { className: 'dsh-cron-form-group', style: { marginTop: '12px', marginBottom: 0 } },
+                    React.createElement('label', null, T_KEY(t, 'form.silentRuleLabel')),
+                    React.createElement('input', {
+                      type: 'text',
+                      value: formSilentRule,
+                      placeholder: T_KEY(t, 'form.silentRulePlaceholder'),
+                      onChange: (e) => setFormSilentRule(e.target.value)
+                    }),
+                    React.createElement('div', { className: 'dsh-cron-hint' }, T_KEY(t, 'form.silentRuleHint'))
                   )
                 ),
                 selectedTaskMeta && React.createElement('div', {

package/lib/failure-inspector.js

@@ -0,0 +1,107 @@
+/**
+ * Failure inspector (#43): after a run fails, ask the model what went wrong and
+ * what to change in the task.
+ *
+ * The value is speed: instead of reading a stack trace or a wall of logs, the
+ * history entry carries a short diagnosis and a proposed prompt change the user
+ * can apply with one click. Nothing is applied automatically.
+ *
+ * Fail-open like the silent rule: no flag, no model, a failed call or an
+ * unreadable answer leave the run exactly as it was.
+ */
+
+import { askModel, parseJsonAnswer, resolveAskTarget } from './llm-ask.js';
+
+/** Agent-mediated tasks have a prompt worth revising. */
+export const INSPECTABLE_TASK_TYPES = ['llm', 'skill', 'workflow'];
+
+export function supportsInspection(task) {
+  const type = String((task && task.type) || 'llm');
+  return INSPECTABLE_TASK_TYPES.includes(type);
+}
+
+const SYSTEM_PROMPT = [
+  'You diagnose a failed scheduled agent task.',
+  'Answer with a single JSON object and nothing else:',
+  '{"diagnosis": "what went wrong, in one or two sentences", "suggestion": "a concrete improved prompt or configuration change", "confidence": "low"|"medium"|"high"}',
+  'Be specific and short. If the cause is unclear from the material, say so and set confidence to low.',
+].join(' ');
+
+export function buildInspectPrompt(task, runInfo) {
+  const error = String((runInfo && runInfo.error) || '').slice(0, 2000);
+  const output = String((runInfo && runInfo.output) || '').slice(0, 2000);
+  return [
+    `Task: ${task.title || 'scheduled task'} (type: ${task.type || 'llm'})`,
+    `Schedule: ${task.scheduleText || task.schedule || ''}`,
+    task.model ? `Model: ${task.model}` : '',
+    '',
+    'Current prompt:',
+    '```',
+    String(task.prompt || '').slice(0, 2000),
+    '```',
+    '',
+    `Result: ${(runInfo && runInfo.status) || 'error'}`,
+    'Error:',
+    '```',
+    error || '(no error text)',
+    '```',
+    output ? 'Last output:' : '',
+    output ? '```' : '',
+    output,
+    output ? '```' : '',
+  ].filter((line) => line !== '').join('\n');
+}
+
+/** Read a diagnosis out of a model answer; anything unusable is rejected. */
+export function readDiagnosis(text) {
+  const parsed = parseJsonAnswer(text);
+  if (!parsed || !parsed.diagnosis) return { ok: false, error: 'the model did not answer with a diagnosis' };
+  const confidence = ['low', 'medium', 'high'].includes(String(parsed.confidence || '').toLowerCase())
+    ? String(parsed.confidence).toLowerCase()
+    : 'low';
+  return {
+    ok: true,
+    diagnosis: String(parsed.diagnosis).slice(0, 1000),
+    suggestion: String(parsed.suggestion || '').slice(0, 2000),
+    confidence,
+  };
+}
+
+/**
+ * Inspect a failed run. Returns `{ inspected: true, diagnosis, suggestion,
+ * confidence }` or `{ inspected: false, error }` — never throws.
+ */
+export async function inspectFailure({ task, runInfo, ask, preferredModel, timeoutMs }) {
+  // Order matters: an inspection only ever concerns failed runs, so a healthy
+  // run must not produce a "no model available" warning.
+  const status = (runInfo && runInfo.status) || '';
+  if (status !== 'error' && status !== 'timeout') return { inspected: false };
+  if (!task || !task.inspectOnFailure) return { inspected: false };
+  if (!supportsInspection(task)) return { inspected: false, error: 'this task type has no prompt to revise' };
+  if (typeof ask !== 'function') return { inspected: false, error: 'no model is available for the inspection' };
+
+  try {
+    const result = await ask({
+      task,
+      prompt: buildInspectPrompt(task, runInfo),
+      system: SYSTEM_PROMPT,
+      preferredModel,
+      maxTokens: 400,
+      timeoutMs,
+    });
+    if (!result || !result.ok) return { inspected: false, error: (result && result.error) || 'the model call failed' };
+    const diagnosis = readDiagnosis(result.text);
+    if (!diagnosis.ok) return { inspected: false, error: diagnosis.error };
+    return { inspected: true, diagnosis: diagnosis.diagnosis, suggestion: diagnosis.suggestion, confidence: diagnosis.confidence };
+  } catch (err) {
+    return { inspected: false, error: (err && err.message) || String(err) };
+  }
+}
+
+/** Ask helper bound to a context, used by the scheduler. */
+export function makeInspectAsk(ctx) {
+  return async ({ prompt, system, preferredModel, maxTokens, timeoutMs, task }) => {
+    const target = resolveAskTarget(ctx, task || {}, preferredModel);
+    return askModel(ctx, { ...target, prompt, system, maxTokens, timeoutMs });
+  };
+}

package/lib/http-utils.js

@@ -85,3 +85,27 @@ export function pickPatchableFields(body, allowed) {
   }
   return patch;
 }
+
+export function sendJson(res, statusCode, data) {
+  res.writeHead(statusCode, { 'Content-Type': 'application/json' });
+  res.end(JSON.stringify(data));
+}
+
+export function rejectCrossOrigin(req, res) {
+  if (isCrossOrigin(req)) {
+    sendJson(res, 403, { ok: false, error: 'Cross-origin request rejected' });
+    return true;
+  }
+  return false;
+}
+
+export async function readBody(req, res) {
+  try {
+    return { body: await parseJsonBody(req) };
+  } catch (err) {
+    sendJson(res, err.statusCode || 400, { ok: false, error: err.message });
+    return { error: true };
+  }
+}
+
+/** Settings keys synchronized between the store and the settings service. */