clementine-agent 1.18.170 → 1.18.172

package/dist/agent/background-tasks.js

@@ -113,6 +113,14 @@ export function markRunning(id, opts) {
     safeWrite(pathFor(id, opts), task);
     return task;
 }
+function writeFullResultFile(id, result, opts) {
+    if (result.length <= RESULT_TRUNCATE_BYTES)
+        return undefined;
+    const file = path.join(dirFor(opts), `${id}.result.md`);
+    mkdirSync(path.dirname(file), { recursive: true });
+    writeFileSync(file, result);
+    return file;
+}
 /** Transition to 'done' with final result. */
 export function markDone(id, result, deliverableNote, opts) {
     const task = loadBackgroundTask(id, opts);
@@ -122,9 +130,14 @@ export function markDone(id, result, deliverableNote, opts) {
         return task;
     task.status = 'done';
     task.completedAt = new Date().toISOString();
+    const resultPath = writeFullResultFile(id, result, opts);
+    if (resultPath)
+        task.resultPath = resultPath;
     task.result = result;
     if (deliverableNote)
         task.deliverableNote = deliverableNote;
+    else if (resultPath)
+        task.deliverableNote = resultPath;
     safeWrite(pathFor(id, opts), task);
     return task;
 }

package/dist/agent/chat-skill-resolver.js

@@ -58,10 +58,21 @@ import pino from 'pino';
 import { searchSkills } from './skill-extractor.js';
 const logger = pino({ name: 'clementine.chat-skill-resolver' });
 // ── Tunables ──────────────────────────────────────────────────────────
-/** Default minimum score to consider a skill match real. Mirrors the
- *  legacy `assistant.ts:1492` threshold. Skill auto-match is heuristic;
- *  this filter keeps weak matches from injecting unrelated tooling. */
+/** Default minimum score for user-authored skill matches. Mirrors the
+ *  legacy `assistant.ts:1492` threshold. */
 const DEFAULT_MIN_SCORE = 4;
+/** Higher threshold applied when ALL matches are auto-generated MCP-derived
+ *  skills (no user-authored signal). 1.18.171 hotfix: a vague chat message
+ *  ("did our changes break it?") matched three unrelated auto-skills
+ *  (ElevenLabs + apify) at score 5.5 each because semantic-only matching
+ *  drifted toward whatever embeddings were closest. Bumping the bar for
+ *  auto-only match-sets keeps that noise out of the system prompt. */
+const AUTO_ONLY_MIN_SCORE = 8;
+/** When ALL matches are auto-generated AND they reference this many or
+ *  more distinct servers, the cluster is treated as semantic-noise and
+ *  the injection is skipped entirely. Three different services have no
+ *  business being "all relevant" to a single user message. */
+const AUTO_ONLY_SERVER_NOISE_THRESHOLD = 3;
 /** Default top-K matches to aggregate. Single-tool requests usually
  *  return one strong match; category requests ("salesforce") return
  *  several similarly-scored auto-skills. Top-3 covers both. Raising
@@ -228,9 +239,36 @@ export function resolveSkillsForChat(userMessage, opts = {}) {
         logger.debug({ err }, 'chat-skill-resolver: searchSkills failed (non-fatal)');
         return empty;
     }
-    const matches = candidates
-        .filter((m) => m.score >= minScore)
+    // 1.18.171 hotfix: detect auto-only match-sets and apply the higher
+    // threshold + noise-cluster filter so vague chat messages don't surface
+    // unrelated MCP context. See the comment block on AUTO_ONLY_MIN_SCORE.
+    const isAutoMatch = (m) => m.name.startsWith('auto-');
+    const candidatesAllAuto = candidates.length > 0 && candidates.every(isAutoMatch);
+    const effectiveMinScore = candidatesAllAuto
+        ? Math.max(minScore, AUTO_ONLY_MIN_SCORE)
+        : minScore;
+    let matches = candidates
+        .filter((m) => m.score >= effectiveMinScore)
         .slice(0, limit);
+    // Auto-only noise cluster filter: when every survivor is auto AND they
+    // collectively reference too many distinct servers (no semantic
+    // clustering on a single service), treat as drift and drop.
+    if (matches.length >= 2 && matches.every(isAutoMatch)) {
+        const seenServers = new Set();
+        for (const m of matches) {
+            for (const s of extractMcpServersFromMatch(m))
+                seenServers.add(s);
+        }
+        if (seenServers.size >= AUTO_ONLY_SERVER_NOISE_THRESHOLD) {
+            logger.info({
+                droppedMatches: matches.map(m => ({ name: m.name, score: Number(m.score.toFixed(2)) })),
+                distinctServers: [...seenServers],
+                reason: 'auto_only_server_cluster_too_wide',
+                queryChars,
+            }, 'chat-skill-resolver: dropped match-set (semantic noise)');
+            matches = [];
+        }
+    }
     if (matches.length === 0) {
         return {
             ...empty,

package/dist/agent/complex-task-detector.d.ts

@@ -0,0 +1,9 @@
+export interface ComplexTaskRecommendation {
+    score: number;
+    reasons: string[];
+    suggestedMaxMinutes: number;
+    plan: string[];
+    queueImmediately: boolean;
+}
+export declare function detectComplexTaskForBackground(text: string): ComplexTaskRecommendation | null;
+//# sourceMappingURL=complex-task-detector.d.ts.map

package/dist/agent/complex-task-detector.js

@@ -0,0 +1,118 @@
+const SKILL_AUTHORING_RE = /\b(create|make|build|draft|write|teach|save|update)\b.{0,40}\b(skill|SKILL\.md)\b|\bskill[- ]creator\b/i;
+const EXPLICIT_BACKGROUND_RE = /\b(background|deep mode|keep working|don't stop|dont stop|autonomous|long[- ]running|run overnight|take your time)\b/i;
+const COMPLEX_WORK_RE = /\b(audit|research|analy[sz]e|review|scrape|crawl|extract|enrich|compile|compare|verify|cross[- ]check|triage|reconcile|draft|generate|update|sync|report back|write back)\b/i;
+const BATCH_RE = /\b(all|every|each|bulk|batch|list of|contacts?|leads?|accounts?|tasks?|tickets?|records?|rows?|pages?|repos?|projects?)\b/i;
+const SIDE_EFFECT_RE = /\b(update|write|create|draft|send|post|comment|reply|upload|append|sync|mark|close|move)\b/i;
+const MULTI_STEP_RE = /\b(and then|then|after that|finally|from .* to |against .* and |across|compile .* into|check .* then)\b/i;
+const SYSTEM_KEYWORDS = [
+    'asana',
+    'salesforce',
+    'google sheet',
+    'google sheets',
+    'sheet',
+    'sheets',
+    'dataforseo',
+    'hubspot',
+    'notion',
+    'github',
+    'gmail',
+    'outlook',
+    'slack',
+    'discord',
+    'website',
+    'websites',
+    'crm',
+    'spreadsheet',
+    'csv',
+    'airtable',
+    'linear',
+    'jira',
+];
+function countSystemMentions(text) {
+    const lower = text.toLowerCase();
+    let count = 0;
+    for (const keyword of SYSTEM_KEYWORDS) {
+        if (lower.includes(keyword))
+            count++;
+    }
+    return count;
+}
+function estimatedMinutes(score, systemCount) {
+    if (score >= 8 || systemCount >= 4)
+        return 90;
+    if (score >= 6 || systemCount >= 3)
+        return 60;
+    return 30;
+}
+function buildPlan(text, systemCount) {
+    const lower = text.toLowerCase();
+    const plan = [];
+    plan.push('Confirm the exact scope, filters, and write/send permissions before making side-effecting changes.');
+    if (systemCount > 0) {
+        plan.push('Connect to the named systems with official MCP/API/CLI tools and use the narrowest reliable query.');
+    }
+    else {
+        plan.push('Gather the source material with the available project, file, web, memory, or CLI tools.');
+    }
+    if (BATCH_RE.test(text)) {
+        plan.push('Process records in batches, track counts, and keep skipped/error records separate.');
+    }
+    if (lower.includes('enrich') || lower.includes('dataforseo')) {
+        plan.push('Enrich only qualified records and keep the signal used for each output row or draft.');
+    }
+    if (SIDE_EFFECT_RE.test(text)) {
+        plan.push('Create drafts or updates first; only send or commit irreversible changes after explicit approval.');
+    }
+    plan.push('Return a concise final report with counts, changed locations, failures, and recommended next action.');
+    return plan.slice(0, 6);
+}
+export function detectComplexTaskForBackground(text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return null;
+    if (SKILL_AUTHORING_RE.test(trimmed))
+        return null;
+    const systemCount = countSystemMentions(trimmed);
+    const reasons = [];
+    let score = 0;
+    if (EXPLICIT_BACKGROUND_RE.test(trimmed)) {
+        score += 4;
+        reasons.push('explicit background/deep-work wording');
+    }
+    if (COMPLEX_WORK_RE.test(trimmed)) {
+        score += 2;
+        reasons.push('multi-step work verb');
+    }
+    if (BATCH_RE.test(trimmed)) {
+        score += 2;
+        reasons.push('batch or many-record scope');
+    }
+    if (SIDE_EFFECT_RE.test(trimmed)) {
+        score += 1;
+        reasons.push('write/draft/update side effects');
+    }
+    if (MULTI_STEP_RE.test(trimmed)) {
+        score += 1;
+        reasons.push('multi-step sequencing');
+    }
+    if (systemCount >= 2) {
+        score += Math.min(4, systemCount);
+        reasons.push(`${systemCount} named systems or data surfaces`);
+    }
+    if (trimmed.length > 450) {
+        score += 1;
+        reasons.push('long detailed request');
+    }
+    const queueImmediately = EXPLICIT_BACKGROUND_RE.test(trimmed) && score >= 5;
+    const shouldOffer = queueImmediately || score >= 5 || (systemCount >= 2 && (BATCH_RE.test(trimmed) || SIDE_EFFECT_RE.test(trimmed)));
+    if (!shouldOffer)
+        return null;
+    return {
+        score,
+        reasons,
+        suggestedMaxMinutes: estimatedMinutes(score, systemCount),
+        plan: buildPlan(trimmed, systemCount),
+        queueImmediately,
+    };
+}
+//# sourceMappingURL=complex-task-detector.js.map

package/dist/cli/dashboard.js

@@ -2936,6 +2936,40 @@ export async function cmdDashboard(opts) {
             res.status(500).json({ error: String(err).slice(0, 200) });
         }
     });
+    app.post('/api/background-offers/:id/accept', async (req, res) => {
+        try {
+            const id = req.params.id;
+            if (!/^bo-[a-z0-9]+-[a-z0-9]{3,10}$/.test(id)) {
+                res.status(400).json({ error: 'Invalid background offer id' });
+                return;
+            }
+            const gateway = await getGateway();
+            const result = gateway.acceptBackgroundOffer('dashboard:web', id);
+            if (!result.ok) {
+                res.status(404).json({ ok: false, error: result.response });
+                return;
+            }
+            res.json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err).slice(0, 200) });
+        }
+    });
+    app.post('/api/background-offers/:id/dismiss', async (req, res) => {
+        try {
+            const id = req.params.id;
+            if (!/^bo-[a-z0-9]+-[a-z0-9]{3,10}$/.test(id)) {
+                res.status(400).json({ error: 'Invalid background offer id' });
+                return;
+            }
+            const gateway = await getGateway();
+            const result = gateway.dismissBackgroundOffer('dashboard:web', id);
+            res.status(result.ok ? 200 : 404).json(result.ok ? result : { ok: false, error: result.response });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err).slice(0, 200) });
+        }
+    });
     app.get('/api/heartbeat/agent/:slug', (req, res) => {
         const slug = req.params.slug;
         const state = getHeartbeat();
@@ -21604,40 +21638,54 @@ if('serviceWorker' in navigator){navigator.serviceWorker.getRegistrations().then
           </div>
         </div>
         <div style="display:flex;align-items:center;gap:8px;flex-shrink:0">
-          <button class="btn-secondary" onclick="openSkillStudio()" style="font-size:13px;padding:8px 14px;border-radius:6px;border:1px solid var(--border);background:var(--bg-secondary);color:var(--text-primary);font-weight:500;cursor:pointer;display:inline-flex;align-items:center;gap:6px" title="Open the conversational Skill Studio">
+          <button class="btn-secondary" onclick="openSkillStudio()" style="font-size:13px;padding:8px 14px;border-radius:6px;border:1px solid var(--border);background:var(--bg-secondary);color:var(--text-primary);font-weight:500;cursor:pointer;display:inline-flex;align-items:center;gap:6px" title="Open the natural-language Skill Studio">
             Open Studio
           </button>
-          <button class="btn-primary" onclick="openCreateSkillModalFromComposer()" style="font-size:13px;padding:8px 14px;border-radius:6px;border:none;background:var(--accent);color:#fff;font-weight:500;cursor:pointer;display:inline-flex;align-items:center;gap:6px" title="Open a clean blank skill editor">
-            Blank skill
+          <button class="btn-primary" onclick="openCreateSkillModalFromComposer()" style="font-size:13px;padding:8px 14px;border-radius:6px;border:none;background:var(--accent);color:#fff;font-weight:500;cursor:pointer;display:inline-flex;align-items:center;gap:6px" title="Open a blank SKILL.md editor">
+            Manual editor
           </button>
         </div>
       </div>
+      <div id="skill-composer-home">
       <div id="skill-composer" style="margin:0 0 16px;border:1px solid var(--border);border-radius:8px;background:var(--bg-secondary);padding:14px 16px">
-        <div style="display:grid;grid-template-columns:minmax(280px,1.2fr) minmax(260px,0.8fr);gap:14px;align-items:start">
+        <div style="display:flex;align-items:flex-start;justify-content:space-between;gap:14px;margin-bottom:12px">
+          <div style="min-width:0">
+            <div style="font-size:14px;font-weight:600;color:var(--text-primary);margin-bottom:3px">Skill Studio</div>
+            <div style="font-size:12px;color:var(--text-muted);line-height:1.45">Describe reusable work in plain language. Optional starting points only seed the draft; nothing runs until you save or test it.</div>
+          </div>
+          <div style="font-size:10px;color:var(--text-muted);text-transform:uppercase;letter-spacing:0.04em;white-space:nowrap;margin-top:2px">Natural language first</div>
+        </div>
+        <div style="display:grid;grid-template-columns:repeat(auto-fit,minmax(280px,1fr));gap:14px;align-items:start">
           <div>
-            <label for="skill-composer-text" style="display:block;font-size:11px;font-weight:600;color:var(--text-muted);text-transform:uppercase;letter-spacing:0.04em;margin-bottom:6px">Describe the skill</label>
-            <textarea id="skill-composer-text" rows="4" oninput="updateSkillComposerDraftState()" placeholder="Review my Asana tasks, update a Google Sheet, verify four source systems, then report back in Asana." style="width:100%;box-sizing:border-box;padding:10px 12px;border:1px solid var(--border);border-radius:6px;background:var(--bg-primary);color:var(--text-primary);font-size:13px;line-height:1.45;resize:vertical;min-height:92px"></textarea>
+            <label for="skill-composer-text" style="display:block;font-size:11px;font-weight:600;color:var(--text-muted);text-transform:uppercase;letter-spacing:0.04em;margin-bottom:6px">What should Clementine learn?</label>
+            <textarea id="skill-composer-text" rows="5" oninput="updateSkillComposerDraftState()" placeholder="Find Salesforce contacts I have not touched in 15 days, enrich the accounts with DataForSEO signals, draft cold prospecting emails, then report the drafts back for review." style="width:100%;box-sizing:border-box;padding:10px 12px;border:1px solid var(--border);border-radius:6px;background:var(--bg-primary);color:var(--text-primary);font-size:13px;line-height:1.45;resize:vertical;min-height:112px"></textarea>
+            <div style="margin-top:8px;font-size:11px;color:var(--text-muted);line-height:1.45">Good skills name the repeatable outcome, required tools or data, approval boundaries, and what counts as done.</div>
           </div>
           <div>
-            <div style="font-size:11px;font-weight:600;color:var(--text-muted);text-transform:uppercase;letter-spacing:0.04em;margin-bottom:6px">Starting point</div>
+            <div style="font-size:11px;font-weight:600;color:var(--text-muted);text-transform:uppercase;letter-spacing:0.04em;margin-bottom:6px">Optional starting points</div>
             <div id="skill-composer-modes" style="display:grid;grid-template-columns:repeat(5,minmax(0,1fr));gap:4px;margin-bottom:10px">
               <button type="button" class="skill-composer-mode" data-kind="outcome" onclick="setSkillComposerMode('outcome')" style="padding:7px 6px;border:1px solid var(--accent);border-radius:6px;background:rgba(255,141,0,0.10);color:var(--accent);font-size:11px;font-weight:600;cursor:pointer">Outcome</button>
-              <button type="button" class="skill-composer-mode" data-kind="tool" onclick="setSkillComposerMode('tool')" style="padding:7px 6px;border:1px solid var(--border);border-radius:6px;background:var(--bg-primary);color:var(--text-secondary);font-size:11px;font-weight:600;cursor:pointer">Tool/MCP</button>
+              <button type="button" class="skill-composer-mode" data-kind="tool" onclick="setSkillComposerMode('tool')" style="padding:7px 6px;border:1px solid var(--border);border-radius:6px;background:var(--bg-primary);color:var(--text-secondary);font-size:11px;font-weight:600;cursor:pointer">MCP/API</button>
               <button type="button" class="skill-composer-mode" data-kind="cli" onclick="setSkillComposerMode('cli')" style="padding:7px 6px;border:1px solid var(--border);border-radius:6px;background:var(--bg-primary);color:var(--text-secondary);font-size:11px;font-weight:600;cursor:pointer">CLI</button>
               <button type="button" class="skill-composer-mode" data-kind="project" onclick="setSkillComposerMode('project')" style="padding:7px 6px;border:1px solid var(--border);border-radius:6px;background:var(--bg-primary);color:var(--text-secondary);font-size:11px;font-weight:600;cursor:pointer">Project</button>
               <button type="button" class="skill-composer-mode" data-kind="memory" onclick="setSkillComposerMode('memory')" style="padding:7px 6px;border:1px solid var(--border);border-radius:6px;background:var(--bg-primary);color:var(--text-secondary);font-size:11px;font-weight:600;cursor:pointer">Memory</button>
             </div>
             <label id="skill-composer-anchor-label" for="skill-composer-anchor" style="display:block;font-size:11px;font-weight:600;color:var(--text-muted);text-transform:uppercase;letter-spacing:0.04em;margin-bottom:6px">Anchor</label>
-            <input id="skill-composer-anchor" list="skill-composer-anchor-options" oninput="updateSkillComposerDraftState()" placeholder="Optional tool, project, command, or memory source" style="width:100%;box-sizing:border-box;padding:9px 10px;border:1px solid var(--border);border-radius:6px;background:var(--bg-primary);color:var(--text-primary);font-size:12px">
+            <div style="display:flex;gap:6px;align-items:center">
+              <input id="skill-composer-anchor" list="skill-composer-anchor-options" oninput="updateSkillComposerDraftState()" onkeydown="if(event.key==='Enter'){event.preventDefault();addSkillComposerDependency();}" placeholder="Optional tool, project, command, or memory source" style="flex:1;min-width:0;box-sizing:border-box;padding:9px 10px;border:1px solid var(--border);border-radius:6px;background:var(--bg-primary);color:var(--text-primary);font-size:12px">
+              <button type="button" class="btn-secondary" onclick="addSkillComposerDependency()" style="font-size:12px;padding:8px 10px;border-radius:6px;border:1px solid var(--border);background:transparent;color:var(--text-primary);cursor:pointer">Add</button>
+            </div>
             <datalist id="skill-composer-anchor-options"></datalist>
             <div id="skill-composer-anchor-summary" style="margin-top:8px;min-height:22px;font-size:11px;color:var(--text-muted);line-height:1.45">No starting point selected.</div>
+            <div id="skill-composer-preview" style="margin-top:10px;max-height:180px;overflow:auto;border:1px solid var(--border);border-radius:6px;background:var(--bg-primary);padding:10px 12px;font-size:11px;line-height:1.45;color:var(--text-secondary)"></div>
             <div style="display:flex;align-items:center;justify-content:flex-end;gap:8px;margin-top:12px">
-              <button type="button" class="btn-secondary" onclick="openSkillStudio()" style="font-size:12px;padding:7px 12px;border-radius:6px;border:1px solid var(--border);background:transparent;color:var(--text-primary);cursor:pointer">Open Studio</button>
-              <button type="button" class="btn-primary" id="skill-composer-draft-btn" onclick="startSkillComposerDraft()" disabled style="font-size:12px;padding:7px 14px;border-radius:6px;border:none;background:var(--accent);color:#fff;font-weight:600;cursor:pointer;opacity:0.55">Draft skill</button>
+              <button type="button" class="btn-secondary" onclick="startSkillComposerChat()" style="font-size:12px;padding:7px 12px;border-radius:6px;border:1px solid var(--border);background:transparent;color:var(--text-primary);cursor:pointer">Build in chat</button>
+              <button type="button" class="btn-primary" id="skill-composer-draft-btn" onclick="startSkillComposerDraft()" disabled style="font-size:12px;padding:7px 14px;border-radius:6px;border:none;background:var(--accent);color:#fff;font-weight:600;cursor:pointer;opacity:0.55">Review draft</button>
             </div>
           </div>
         </div>
       </div>
+      </div>
       <div style="display:grid;grid-template-columns:380px 1fr;gap:18px;height:calc(100vh - 360px);min-height:440px">
         <div id="skills-list-pane" style="overflow-y:auto;border:1px solid var(--border);border-radius:8px;background:var(--bg-secondary)">
           <div style="padding:14px 16px;border-bottom:1px solid var(--border);display:flex;align-items:center;gap:8px">
@@ -28725,6 +28773,7 @@ var _skillsState = {
 
 var _skillComposerMode = 'outcome';
 var _skillComposerOptionsCache = null;
+var _skillComposerDependencies = [];
 
 var _skillComposerCopy = {
   outcome: {
@@ -28785,34 +28834,77 @@ function updateSkillComposerDraftState() {
   var text = (document.getElementById('skill-composer-text') || {}).value || '';
   var anchor = (document.getElementById('skill-composer-anchor') || {}).value || '';
   var btn = document.getElementById('skill-composer-draft-btn');
-  var enabled = !!(text.trim() || anchor.trim());
+  var enabled = !!(text.trim() || anchor.trim() || _skillComposerDependencies.length);
   if (btn) {
     btn.disabled = !enabled;
     btn.style.opacity = enabled ? '1' : '0.55';
     btn.style.cursor = enabled ? 'pointer' : 'not-allowed';
   }
   renderSkillComposerAnchorSummary(text, anchor);
+  renderSkillComposerPreview();
 }
 
 function renderSkillComposerAnchorSummary(text, anchor) {
   var box = document.getElementById('skill-composer-anchor-summary');
   if (!box) return;
   var trimmed = String(anchor || '').trim();
-  if (!trimmed) {
+  var deps = getSkillComposerDependencies(false);
+  if (!trimmed && deps.length === 0) {
     box.innerHTML = '<span style="color:var(--text-muted)">No starting point selected.</span>';
     return;
   }
-  var modeCopy = _skillComposerCopy[_skillComposerMode] || _skillComposerCopy.outcome;
-  var tools = inferSkillComposerTools(_skillComposerMode, trimmed);
-  var toolText = tools.length
-    ? tools.map(function(t) { return '<code style="font-size:10px;background:var(--bg-primary);border:1px solid var(--border);padding:1px 5px;border-radius:4px;color:var(--text-primary)">' + esc(t) + '</code>'; }).join(' ')
-    : '<span style="color:var(--text-muted)">no explicit tool allowlist</span>';
-  box.innerHTML = '<div style="display:flex;align-items:flex-start;gap:6px;flex-wrap:wrap">'
-    + '<span style="color:var(--accent);font-weight:600">' + esc(modeCopy.promptLabel) + ':</span>'
-    + '<code style="font-size:10px;background:var(--bg-primary);border:1px solid var(--border);padding:1px 5px;border-radius:4px;color:var(--text-primary);max-width:100%;overflow:hidden;text-overflow:ellipsis">' + esc(trimmed) + '</code>'
-    + '<span style="color:var(--text-muted)">will seed</span>'
-    + toolText
-    + '</div>';
+  var html = '<div style="display:flex;align-items:center;gap:6px;flex-wrap:wrap">';
+  for (var i = 0; i < deps.length; i++) {
+    var dep = deps[i];
+    var copy = _skillComposerCopy[dep.mode] || _skillComposerCopy.outcome;
+    html += '<span style="display:inline-flex;align-items:center;gap:5px;max-width:100%;padding:2px 7px;border:1px solid var(--border);border-radius:999px;background:var(--bg-primary);color:var(--text-primary);font-size:10px">'
+      + '<strong style="color:var(--accent);font-weight:600">' + esc(copy.promptLabel) + '</strong>'
+      + '<span style="overflow:hidden;text-overflow:ellipsis;white-space:nowrap;max-width:190px">' + esc(dep.value) + '</span>'
+      + '<button type="button" onclick="removeSkillComposerDependency(' + i + ')" title="Remove" style="border:none;background:transparent;color:var(--text-muted);cursor:pointer;padding:0;font-size:12px;line-height:1">&times;</button>'
+      + '</span>';
+  }
+  if (trimmed) {
+    var modeCopy = _skillComposerCopy[_skillComposerMode] || _skillComposerCopy.outcome;
+    var tools = inferSkillComposerTools(_skillComposerMode, trimmed);
+    html += '<span style="color:var(--text-muted)">Pending ' + esc(modeCopy.promptLabel) + ':</span>'
+      + '<code style="font-size:10px;background:var(--bg-primary);border:1px solid var(--border);padding:1px 5px;border-radius:4px;color:var(--text-primary);max-width:100%;overflow:hidden;text-overflow:ellipsis">' + esc(trimmed) + '</code>'
+      + (tools.length ? '<span style="color:var(--text-muted)">adds ' + esc(tools.join(', ')) + '</span>' : '');
+  }
+  html += '</div>';
+  box.innerHTML = html;
+}
+
+function getSkillComposerDependencies(includePending) {
+  var deps = _skillComposerDependencies.slice();
+  if (includePending) {
+    var pending = ((document.getElementById('skill-composer-anchor') || {}).value || '').trim();
+    if (pending) deps.push({ mode: _skillComposerMode || 'outcome', value: pending });
+  }
+  var seen = {};
+  return deps.filter(function(dep) {
+    var key = dep.mode + ':' + dep.value;
+    if (seen[key]) return false;
+    seen[key] = true;
+    return true;
+  });
+}
+
+function addSkillComposerDependency() {
+  var input = document.getElementById('skill-composer-anchor');
+  var value = (input && input.value || '').trim();
+  if (!value) return;
+  var mode = _skillComposerMode || 'outcome';
+  var key = mode + ':' + value;
+  var exists = _skillComposerDependencies.some(function(dep) { return dep.mode + ':' + dep.value === key; });
+  if (!exists) _skillComposerDependencies.push({ mode: mode, value: value });
+  if (input) input.value = '';
+  updateSkillComposerDraftState();
+}
+
+function removeSkillComposerDependency(index) {
+  if (index < 0 || index >= _skillComposerDependencies.length) return;
+  _skillComposerDependencies.splice(index, 1);
+  updateSkillComposerDraftState();
 }
 
 function inferSkillComposerTools(mode, anchor) {
@@ -28888,12 +28980,19 @@ function slugifySkillTitle(title) {
 
 function buildSkillComposerDraftSeed() {
   var text = ((document.getElementById('skill-composer-text') || {}).value || '').trim();
-  var anchor = ((document.getElementById('skill-composer-anchor') || {}).value || '').trim();
   var mode = _skillComposerMode || 'outcome';
   var modeCopy = _skillComposerCopy[mode] || _skillComposerCopy.outcome;
+  var deps = getSkillComposerDependencies(true);
+  var anchor = deps.map(function(dep) {
+    var copy = _skillComposerCopy[dep.mode] || _skillComposerCopy.outcome;
+    return copy.promptLabel + ': ' + dep.value;
+  }).join('; ');
   var title = inferSkillComposerTitle(text, anchor);
   var name = slugifySkillTitle(title);
-  var tools = inferSkillComposerTools(mode, anchor);
+  var tools = [];
+  for (var di = 0; di < deps.length; di++) {
+    tools = tools.concat(inferSkillComposerTools(deps[di].mode, deps[di].value));
+  }
   var hay = (text + ' ' + anchor).toLowerCase();
   if (hay.indexOf('salesforce') !== -1) tools = dedupeSkillComposerToolNames(tools.concat(['Bash']));
   if (hay.indexOf('dataforseo') !== -1 && tools.indexOf('mcp__dataforseo__*') === -1) tools.push('mcp__dataforseo__*');
@@ -28909,13 +29008,18 @@ function buildSkillComposerDraftSeed() {
   if (description.length > 1024) description = description.slice(0, 1024);
 
   var toolLines = tools.length ? tools.map(function(t) { return '- ' + t; }).join('\\n') : '- No explicit allowlist yet; add only the tools this skill truly needs.';
-  var anchorLine = anchor ? modeCopy.promptLabel + ': ' + anchor : 'None selected';
+  var anchorLine = deps.length
+    ? deps.map(function(dep) {
+        var copy = _skillComposerCopy[dep.mode] || _skillComposerCopy.outcome;
+        return '- ' + copy.promptLabel + ': ' + dep.value;
+      }).join('\\n')
+    : '- None selected';
   var body = '# ' + title + '\\n\\n'
     + '## Use When\\n\\n'
     + description + '\\n\\n'
     + '## Starting Point\\n\\n'
     + '- Outcome: ' + (text || 'Fill in the exact user goal before saving.') + '\\n'
-    + '- ' + anchorLine + '\\n\\n'
+    + anchorLine + '\\n\\n'
     + '## Required Tools\\n\\n'
     + toolLines + '\\n\\n'
     + '## Procedure\\n\\n'
@@ -28961,10 +29065,37 @@ function buildSkillComposerDraftSeed() {
     description: description,
     body: body,
     tools: tools,
-    note: anchor ? ('Seeded from ' + modeCopy.promptLabel + ': ' + anchor) : 'Seeded from the natural language description.',
+    note: deps.length ? ('Seeded from ' + deps.length + ' starting point' + (deps.length === 1 ? '' : 's') + '.') : 'Seeded from the natural language description.',
   };
 }
 
+function renderSkillComposerPreview() {
+  var box = document.getElementById('skill-composer-preview');
+  if (!box) return;
+  var text = ((document.getElementById('skill-composer-text') || {}).value || '').trim();
+  var deps = getSkillComposerDependencies(true);
+  if (!text && deps.length === 0) {
+    box.innerHTML = '<span style="color:var(--text-muted)">Preview appears here as you describe the skill or add tools.</span>';
+    return;
+  }
+  var seed = buildSkillComposerDraftSeed();
+  var depHtml = deps.length
+    ? deps.map(function(dep) {
+        var copy = _skillComposerCopy[dep.mode] || _skillComposerCopy.outcome;
+        return '<span style="display:inline-flex;margin:0 4px 4px 0;padding:1px 6px;border:1px solid var(--border);border-radius:999px;background:var(--bg-secondary);font-size:10px"><strong style="color:var(--accent);margin-right:4px">' + esc(copy.promptLabel) + '</strong>' + esc(dep.value) + '</span>';
+      }).join('')
+    : '<span style="color:var(--text-muted)">No explicit dependencies yet.</span>';
+  var toolsHtml = seed.tools.length
+    ? seed.tools.map(function(t) { return '<code style="font-size:10px;background:var(--bg-secondary);border:1px solid var(--border);padding:1px 5px;border-radius:4px;color:var(--text-primary);margin-right:4px">' + esc(t) + '</code>'; }).join('')
+    : '<span style="color:var(--text-muted)">inherits default runtime surface</span>';
+  box.innerHTML =
+    '<div style="font-weight:600;color:var(--text-primary);margin-bottom:4px">' + esc(seed.title) + '</div>' +
+    '<div style="color:var(--text-muted);margin-bottom:8px">' + esc(seed.name) + '</div>' +
+    '<div style="margin-bottom:8px"><strong style="color:var(--text-secondary)">Dependencies</strong><br>' + depHtml + '</div>' +
+    '<div style="margin-bottom:8px"><strong style="color:var(--text-secondary)">Tools</strong><br>' + toolsHtml + '</div>' +
+    '<div><strong style="color:var(--text-secondary)">Trigger description</strong><br>' + esc(seed.description.slice(0, 260)) + (seed.description.length > 260 ? '...' : '') + '</div>';
+}
+
 async function hydrateSkillComposerOptions() {
   if (_skillComposerOptionsCache) return _skillComposerOptionsCache;
   var cache = { tool: [], cli: [], project: [], memory: [] };
@@ -29062,15 +29193,21 @@ async function renderSkillComposerOptions() {
 
 function buildSkillComposerPrompt() {
   var text = ((document.getElementById('skill-composer-text') || {}).value || '').trim();
-  var anchor = ((document.getElementById('skill-composer-anchor') || {}).value || '').trim();
-  var modeCopy = _skillComposerCopy[_skillComposerMode] || _skillComposerCopy.outcome;
+  var deps = getSkillComposerDependencies(true);
   var lines = [
     'Use skill-creator principles to draft a Clementine skill in Skill Studio.',
     '',
     'Outcome: ' + (text || '(ask me for the outcome before drafting)'),
-    'Starting point: ' + modeCopy.promptLabel,
+    'Starting points:',
   ];
-  if (anchor) lines.push('Anchor: ' + anchor);
+  if (deps.length) {
+    for (var i = 0; i < deps.length; i++) {
+      var copy = _skillComposerCopy[deps[i].mode] || _skillComposerCopy.outcome;
+      lines.push('- ' + copy.promptLabel + ': ' + deps[i].value);
+    }
+  } else {
+    lines.push('- None selected');
+  }
   lines.push(
     '',
     'Draft rules:',
@@ -29087,6 +29224,17 @@ function startSkillComposerDraft() {
   openCreateSkillModalFromComposer({ draft: true });
 }
 
+function startSkillComposerChat() {
+  var prompt = buildSkillComposerPrompt();
+  if (typeof askClementineWith !== 'function') {
+    toast('Chat is not ready yet. Try again after the dashboard finishes loading.', 'error');
+    return;
+  }
+  closeSkillStudio({ silent: true });
+  askClementineWith(prompt, { autoSend: false });
+  toast('Skill-creator prompt loaded in chat. Press send when you are ready.', 'info');
+}
+
 function openCreateSkillModalFromComposer(opts) {
   opts = opts || {};
   var text = ((document.getElementById('skill-composer-text') || {}).value || '').trim();
@@ -29096,6 +29244,7 @@ function openCreateSkillModalFromComposer(opts) {
     return;
   }
   var seed = buildSkillComposerDraftSeed();
+  closeSkillStudio({ silent: true });
   _openSkillModal({ mode: 'create', prefill: seed });
   if (seed.note && typeof toast === 'function') toast(seed.note, 'success');
 }
@@ -29876,7 +30025,7 @@ async function _openSkillModal(opts) {
       +       '<strong style="color:var(--text-secondary);font-weight:600">Format:</strong> '
       +       '<code style="font-size:10px;background:var(--bg-secondary);padding:1px 4px;border-radius:3px">[WHAT it does] + [WHEN to use it] + [trigger phrases]</code>'
       +       ' &nbsp;·&nbsp; under 1024 chars · no <code style="font-size:10px">&lt; &gt;</code> · '
-      +       '<a href="javascript:void(0)" onclick="askClementineWith(\\x27Use skill-creator to help me write a great Anthropic-canonical description for the skill I am building.\\x27)" style="color:var(--accent);text-decoration:none">use skill-creator</a>'
+      +       '<a href="javascript:void(0)" onclick="askSkillCreatorForDescription()" style="color:var(--accent);text-decoration:none">use skill-creator</a>'
       +     '</div>'
       +     '<textarea id="skill-modal-desc" rows="2" oninput="updateSkillModalCounters()" placeholder="Example: Analyzes Outlook emails and drafts triage replies. Use when user asks to triage email or mentions inbox cleanup." style="width:100%;padding:8px 10px;font-size:13px;border:1px solid var(--border);border-radius:6px;background:var(--bg-secondary);color:var(--text-primary);margin-bottom:12px;font-family:inherit;resize:vertical"></textarea>'
       +     '<label style="display:block;font-size:12px;color:var(--text-secondary);margin-bottom:4px;font-weight:500">Allowed tools <span style="color:var(--text-muted)">(comma-separated, leave blank for default)</span></label>'
@@ -29896,7 +30045,9 @@ async function _openSkillModal(opts) {
       + '</div>';
     document.body.appendChild(modal);
   }
-  document.getElementById('skill-modal-heading').textContent = opts.mode === 'edit' ? 'Edit skill: ' + nameVal : 'New skill';
+  document.getElementById('skill-modal-heading').textContent = opts.mode === 'edit'
+    ? 'Edit skill: ' + nameVal
+    : (prefill.note ? 'Review skill draft' : 'Manual skill editor');
   document.getElementById('skill-modal-original-name').value = opts.mode === 'edit' ? nameVal : '';
   document.getElementById('skill-modal-name').value = nameVal;
   document.getElementById('skill-modal-name').disabled = opts.mode === 'edit';
@@ -29917,7 +30068,8 @@ async function _openSkillModal(opts) {
   var errEl = document.getElementById('skill-modal-error');
   if (errEl) { errEl.style.display = 'none'; errEl.textContent = ''; }
   modal.style.display = 'flex';
-  document.getElementById('skill-modal-name').focus();
+  var initialFocus = prefill.note ? document.getElementById('skill-modal-desc') : document.getElementById('skill-modal-name');
+  if (initialFocus) initialFocus.focus();
   if (typeof updateSkillModalCounters === 'function') updateSkillModalCounters();
   if (typeof renderSkillModalToolsPreview === 'function') renderSkillModalToolsPreview();
   // 1.18.168 — render the compact optional template seed in create mode only.
@@ -34514,6 +34666,54 @@ function renderMd(text) {
   return s;
 }
 
+function extractBackgroundOfferId(text) {
+  var m = String(text || '').match(/Background offer:\s*(bo-[a-z0-9]+-[a-z0-9]{3,10})/i);
+  return m ? m[1] : '';
+}
+
+function appendBackgroundOfferActions(bubble, text) {
+  if (!bubble || bubble.querySelector('.chat-bg-offer-actions')) return;
+  var id = extractBackgroundOfferId(text);
+  if (!id) return;
+  var panel = document.createElement('div');
+  panel.className = 'chat-bg-offer-actions';
+  panel.style.cssText = 'margin-top:10px;display:flex;gap:6px;flex-wrap:wrap;padding-top:8px;border-top:1px solid var(--border)';
+  panel.innerHTML =
+    '<button class="btn-sm btn-primary" data-bg-action="accept" style="font-size:11px;padding:5px 10px">Run in background</button>' +
+    '<button class="btn-sm" data-bg-action="inline" style="font-size:11px;padding:5px 10px">Run inline anyway</button>' +
+    '<button class="btn-sm" data-bg-action="skill" style="font-size:11px;padding:5px 10px">Save as skill first</button>' +
+    '<button class="btn-sm" data-bg-action="dismiss" style="font-size:11px;padding:5px 10px;color:var(--text-muted)">Dismiss</button>';
+  panel.querySelector('[data-bg-action="accept"]').onclick = function() { acceptBackgroundOffer(id, panel); };
+  panel.querySelector('[data-bg-action="inline"]').onclick = function() { askClementineWith('run inline ' + id); };
+  panel.querySelector('[data-bg-action="skill"]').onclick = function() { askClementineWith('save skill ' + id); };
+  panel.querySelector('[data-bg-action="dismiss"]').onclick = function() { dismissBackgroundOffer(id, panel); };
+  bubble.appendChild(panel);
+}
+
+async function acceptBackgroundOffer(id, panel) {
+  if (panel) panel.innerHTML = '<span style="font-size:11px;color:var(--text-muted)">Queueing background task...</span>';
+  try {
+    var r = await apiFetch('/api/background-offers/' + encodeURIComponent(id) + '/accept', { method: 'POST' });
+    var d = await r.json();
+    if (!r.ok || !d.ok) {
+      if (panel) panel.innerHTML = '<span style="font-size:11px;color:var(--red)">' + esc(d.error || 'Failed to queue task') + '</span>';
+      return;
+    }
+    if (panel) panel.innerHTML = '<div style="font-size:12px;line-height:1.45;color:var(--text-secondary)">' + renderMd(d.response || 'Background task queued.') + '</div>';
+    toast('Background task queued', 'success');
+    setTimeout(refreshAll, 500);
+  } catch (err) {
+    if (panel) panel.innerHTML = '<span style="font-size:11px;color:var(--red)">Failed: ' + esc(String(err)) + '</span>';
+  }
+}
+
+async function dismissBackgroundOffer(id, panel) {
+  try {
+    await apiFetch('/api/background-offers/' + encodeURIComponent(id) + '/dismiss', { method: 'POST' });
+  } catch (_) { /* best-effort */ }
+  if (panel) panel.remove();
+}
+
 let chatHistory = [];
 async function sendChat() {
   const input = document.getElementById('chat-input');
@@ -34621,6 +34821,7 @@ async function sendChat() {
 	        finalText = evt.response || finalText || 'No response';
 	        finalTrace = evt.trace || null;
 	        renderAssistantText(finalText);
+	        appendBackgroundOfferActions(asstBubble, finalText);
 	      } else if (evt.type === 'error') {
 	        throw new Error(evt.error || 'Stream error');
 	      }
@@ -35220,7 +35421,7 @@ document.addEventListener('click', function(e) {
 // Back-compat shim — older call sites still reference loadProfiles().
 function loadProfiles() { return refreshChatAgentPicker(); }
 
-// ── Skill Studio — opens the Skills page composer ──────────
+// ── Skill Studio — opens the natural-language composer as a real modal ──────────
 
 function openSkillStudio() {
   navigateTo('skills');
@@ -35228,15 +35429,56 @@ function openSkillStudio() {
     try { initSkillComposer(); } catch (_) { /* non-fatal */ }
     var composer = document.getElementById('skill-composer');
     var input = document.getElementById('skill-composer-text');
-    if (composer && composer.scrollIntoView) composer.scrollIntoView({ behavior: 'smooth', block: 'start' });
-    if (composer) {
-      composer.style.boxShadow = '0 0 0 2px rgba(255,141,0,0.35)';
-      setTimeout(function() { composer.style.boxShadow = ''; }, 1400);
+    var modal = document.getElementById('skill-studio-modal');
+    if (!modal) {
+      modal = document.createElement('div');
+      modal.id = 'skill-studio-modal';
+      modal.style.cssText = 'position:fixed;inset:0;background:rgba(0,0,0,0.42);z-index:1050;display:none;align-items:center;justify-content:center;padding:20px';
+      modal.innerHTML =
+        '<div style="width:min(1040px,96vw);max-height:92vh;background:var(--bg-primary);border:1px solid var(--border);border-radius:10px;box-shadow:0 18px 56px rgba(0,0,0,0.35);display:flex;flex-direction:column;overflow:hidden">'
+        + '<div style="display:flex;align-items:flex-start;justify-content:space-between;gap:14px;padding:16px 20px;border-bottom:1px solid var(--border);background:var(--bg-secondary)">'
+        +   '<div style="min-width:0">'
+        +     '<div style="font-size:16px;font-weight:600;color:var(--text-primary);margin-bottom:3px">Skill Studio</div>'
+        +     '<div style="font-size:12px;color:var(--text-muted);line-height:1.45">Start with the outcome. Add MCP, CLI, project, or memory anchors only when they are real dependencies. Review the generated SKILL.md before saving.</div>'
+        +   '</div>'
+        +   '<button type="button" onclick="closeSkillStudio()" title="Close Skill Studio" style="background:none;border:none;font-size:20px;color:var(--text-muted);cursor:pointer;padding:0 4px;line-height:1">&times;</button>'
+        + '</div>'
+        + '<div id="skill-studio-modal-body" style="padding:18px 20px;overflow:auto;flex:1;min-height:0"></div>'
+        + '<div style="display:flex;align-items:center;gap:8px;justify-content:flex-end;padding:14px 20px;border-top:1px solid var(--border);background:var(--bg-secondary)">'
+        +   '<button type="button" onclick="closeSkillStudio()" style="font-size:13px;padding:7px 14px;border-radius:6px;border:1px solid var(--border);background:transparent;color:var(--text-primary);cursor:pointer">Keep on page</button>'
+        +   '<button type="button" onclick="startSkillComposerChat()" style="font-size:13px;padding:7px 14px;border-radius:6px;border:1px solid var(--border);background:var(--bg-primary);color:var(--text-primary);cursor:pointer">Build in chat</button>'
+        +   '<button type="button" onclick="startSkillComposerDraft()" class="btn-primary" style="font-size:13px;padding:7px 16px;border-radius:6px;border:none;background:var(--accent);color:#fff;font-weight:600;cursor:pointer">Review draft</button>'
+        + '</div>'
+        + '</div>';
+      document.body.appendChild(modal);
+    }
+    var body = document.getElementById('skill-studio-modal-body');
+    if (composer && body && composer.parentElement !== body) {
+      composer.dataset.originalMargin = composer.style.margin || '';
+      body.appendChild(composer);
+      composer.style.margin = '0';
     }
+    modal.style.display = 'flex';
+    updateSkillComposerDraftState();
     if (input) input.focus();
   }, 80);
 }
 
+function closeSkillStudio(opts) {
+  opts = opts || {};
+  var modal = document.getElementById('skill-studio-modal');
+  var composer = document.getElementById('skill-composer');
+  var home = document.getElementById('skill-composer-home');
+  if (composer && home && composer.parentElement !== home) {
+    home.appendChild(composer);
+    composer.style.margin = composer.dataset.originalMargin || '0 0 16px';
+  }
+  if (modal) modal.style.display = 'none';
+  if (!opts.silent && composer && composer.scrollIntoView) {
+    composer.scrollIntoView({ behavior: 'smooth', block: 'start' });
+  }
+}
+
 function updateBuilderMode() {
   var type = (document.getElementById('builder-type') || {}).value || 'skill';
   var title = document.getElementById('builder-page-title');

package/dist/gateway/router.d.ts

@@ -5,7 +5,7 @@
  * Manages per-user/channel sessions for conversation continuity.
  */
 import { PersonalAssistant, type ProjectMeta } from '../agent/assistant.js';
-import type { OnProgressCallback, OnTextCallback, OnToolActivityCallback, SelfImproveConfig, SelfImproveExperiment, SessionProvenance, TeamMessage, VerboseLevel, WorkflowDefinition } from '../types.js';
+import type { BackgroundTask, OnProgressCallback, OnTextCallback, OnToolActivityCallback, SelfImproveConfig, SelfImproveExperiment, SessionProvenance, TeamMessage, VerboseLevel, WorkflowDefinition } from '../types.js';
 import { AgentManager } from '../agent/agent-manager.js';
 import { TeamRouter } from '../agent/team-router.js';
 import { TeamBus } from '../agent/team-bus.js';
@@ -23,6 +23,7 @@ export declare class Gateway {
     private approvalResolvers;
     private approvalCounter;
     private sessions;
+    private pendingBackgroundOffers;
     private auditLog;
     private draining;
     /** Side-channel for the metadata of the *most recent* cron run, populated
@@ -53,6 +54,25 @@ export declare class Gateway {
     private isTrustedPersonalSession;
     private runningUnleashedTasks;
     private extractBackgroundTaskId;
+    private makeBackgroundOfferId;
+    private backgroundAgentForSession;
+    private pruneExpiredBackgroundOffers;
+    private latestBackgroundOfferForSession;
+    private getBackgroundOfferForSession;
+    private createBackgroundOffer;
+    private queueBackgroundOffer;
+    private formatBackgroundQueuedResponse;
+    private formatBackgroundOfferResponse;
+    acceptBackgroundOffer(sessionKey: string, id: string): {
+        ok: boolean;
+        response: string;
+        task?: BackgroundTask;
+    };
+    dismissBackgroundOffer(sessionKey: string, id: string): {
+        ok: boolean;
+        response: string;
+    };
+    private resolveBackgroundOfferControl;
     private isAgentScopedSession;
     private readUnleashedStatus;
     private taskElapsedMinutes;

package/dist/gateway/router.js

@@ -16,7 +16,7 @@ import { lanes } from './lanes.js';
 import { AgentManager } from '../agent/agent-manager.js';
 import { TeamRouter } from '../agent/team-router.js';
 import { TeamBus } from '../agent/team-bus.js';
-import { listBackgroundTasks, loadBackgroundTask, markFailed } from '../agent/background-tasks.js';
+import { createBackgroundTask, listBackgroundTasks, loadBackgroundTask, markFailed } from '../agent/background-tasks.js';
 import { applyAssistantExperienceUpdate, detectApprovalReply, detectLocalTurn } from '../agent/local-turn.js';
 import { buildApprovalFollowupPrompt, detectActionExpectation } from '../agent/action-enforcer.js';
 import { updateClementineJson } from '../config/clementine-json.js';
@@ -36,6 +36,7 @@ import { isLiveUnleashedStatus } from './unleashed-status.js';
 import { buildActiveContextSnapshot } from './active-context.js';
 import { markContextEventBySource } from './context-events.js';
 import { EventLog } from './event-log.js';
+import { detectComplexTaskForBackground } from '../agent/complex-task-detector.js';
 export { isLiveUnleashedStatus } from './unleashed-status.js';
 const logger = pino({ name: 'clementine.gateway' });
 const INTERACTIVE_FAILURE_LOG = path.join(BASE_DIR, 'self-improve', 'interactive-failures.jsonl');
@@ -130,6 +131,7 @@ export class Gateway {
     approvalResolvers = new Map();
     approvalCounter = 0;
     sessions = new Map();
+    pendingBackgroundOffers = new Map();
     auditLog = [];
     draining = false;
     /** Side-channel for the metadata of the *most recent* cron run, populated
@@ -245,15 +247,157 @@ export class Gateway {
     extractBackgroundTaskId(text) {
         return text.match(BACKGROUND_TASK_ID_RE)?.[0]?.toLowerCase();
     }
+    makeBackgroundOfferId() {
+        return `bo-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+    }
+    backgroundAgentForSession(sessionKey) {
+        return this._agentSlugFromSessionKey(sessionKey) ?? this.getSessionProfile(sessionKey) ?? 'clementine';
+    }
+    pruneExpiredBackgroundOffers() {
+        const now = Date.now();
+        for (const [id, offer] of this.pendingBackgroundOffers) {
+            if (offer.expiresAt <= now)
+                this.pendingBackgroundOffers.delete(id);
+        }
+    }
+    latestBackgroundOfferForSession(sessionKey) {
+        this.pruneExpiredBackgroundOffers();
+        const offers = [...this.pendingBackgroundOffers.values()]
+            .filter((offer) => offer.sessionKey === sessionKey)
+            .sort((a, b) => b.createdAt - a.createdAt);
+        return offers[0];
+    }
+    getBackgroundOfferForSession(sessionKey, id) {
+        this.pruneExpiredBackgroundOffers();
+        const offer = this.pendingBackgroundOffers.get(id);
+        if (!offer || offer.sessionKey !== sessionKey)
+            return undefined;
+        return offer;
+    }
+    createBackgroundOffer(sessionKey, prompt, recommendation) {
+        this.pruneExpiredBackgroundOffers();
+        const offer = {
+            id: this.makeBackgroundOfferId(),
+            sessionKey,
+            fromAgent: this.backgroundAgentForSession(sessionKey),
+            prompt,
+            recommendation,
+            createdAt: Date.now(),
+            expiresAt: Date.now() + 30 * 60_000,
+        };
+        this.pendingBackgroundOffers.set(offer.id, offer);
+        return offer;
+    }
+    queueBackgroundOffer(offer) {
+        const task = createBackgroundTask({
+            fromAgent: offer.fromAgent,
+            prompt: offer.prompt,
+            maxMinutes: offer.recommendation.suggestedMaxMinutes,
+            sessionKey: offer.sessionKey,
+        });
+        this.pendingBackgroundOffers.delete(offer.id);
+        logger.info({
+            offerId: offer.id,
+            taskId: task.id,
+            sessionKey: offer.sessionKey,
+            fromAgent: offer.fromAgent,
+            maxMinutes: task.maxMinutes,
+        }, 'Queued background task from chat offer');
+        return task;
+    }
+    formatBackgroundQueuedResponse(task) {
+        return [
+            `Queued background task **${task.id}**.`,
+            '',
+            `It will run as **${task.fromAgent}** with a ${task.maxMinutes} minute cap.`,
+            `Use \`status ${task.id}\` or check the dashboard Background Tasks panel for progress.`,
+        ].join('\n');
+    }
+    formatBackgroundOfferResponse(offer) {
+        const lines = [
+            'This looks like long-running, multi-tool work. I recommend running it in the background so chat does not go stale.',
+            '',
+            '**Plan**',
+            ...offer.recommendation.plan.map((step, idx) => `${idx + 1}. ${step}`),
+            '',
+            `**Why background:** ${offer.recommendation.reasons.join('; ')}.`,
+            `**Estimated cap:** ${offer.recommendation.suggestedMaxMinutes} minutes.`,
+            `**Background offer:** ${offer.id}`,
+            '',
+            `Reply \`run background ${offer.id}\` to queue it, \`run inline ${offer.id}\` to run it in this chat, or \`save skill ${offer.id}\` to make it reusable first.`,
+        ];
+        return lines.join('\n');
+    }
+    acceptBackgroundOffer(sessionKey, id) {
+        const offer = this.getBackgroundOfferForSession(sessionKey, id);
+        if (!offer) {
+            return { ok: false, response: `I could not find an active background offer for ${id}. It may have expired.` };
+        }
+        const task = this.queueBackgroundOffer(offer);
+        return { ok: true, response: this.formatBackgroundQueuedResponse(task), task };
+    }
+    dismissBackgroundOffer(sessionKey, id) {
+        const offer = this.getBackgroundOfferForSession(sessionKey, id);
+        if (!offer)
+            return { ok: false, response: `No active background offer found for ${id}.` };
+        this.pendingBackgroundOffers.delete(id);
+        return { ok: true, response: `Dismissed background offer ${id}.` };
+    }
+    resolveBackgroundOfferControl(sessionKey, text) {
+        const normalized = text.trim().toLowerCase();
+        const explicitOfferId = text.match(/\bbo-[a-z0-9]+-[a-z0-9]{3,10}\b/i)?.[0]?.toLowerCase();
+        const offer = explicitOfferId
+            ? this.getBackgroundOfferForSession(sessionKey, explicitOfferId)
+            : this.latestBackgroundOfferForSession(sessionKey);
+        if (!offer)
+            return null;
+        if (/^(run|start|queue|approve|yes|go|do it).{0,30}\bbackground\b/i.test(normalized)
+            || /^run it in the background\b/i.test(normalized)
+            || /^background\b/i.test(normalized)
+            || /^(yes|yep|approved?|go|do it|please do|start it)$/i.test(normalized)) {
+            const task = this.queueBackgroundOffer(offer);
+            return {
+                response: this.formatBackgroundQueuedResponse(task),
+                executionMode: 'background_queued',
+                backgroundTaskId: task.id,
+            };
+        }
+        if (/^run.{0,30}\binline\b/i.test(normalized) || /^run inline\b/i.test(normalized)) {
+            this.pendingBackgroundOffers.delete(offer.id);
+            return { inlineText: offer.prompt, executionMode: 'inline' };
+        }
+        if (/^(save|create|make|teach).{0,30}\bskill\b/i.test(normalized)) {
+            this.pendingBackgroundOffers.delete(offer.id);
+            return {
+                skillText: [
+                    'Create a reusable Clementine skill for this workflow using skill-creator principles.',
+                    'Write a concise Anthropic-compatible folder-form SKILL.md with clear trigger description, required tools/MCP/CLI dependencies, procedure, success criteria, and failure handling.',
+                    '',
+                    'Original workflow request:',
+                    offer.prompt,
+                ].join('\n'),
+                executionMode: 'inline',
+            };
+        }
+        return null;
+    }
     isAgentScopedSession(sessionKey) {
         return this._agentSlugFromSessionKey(sessionKey) !== undefined;
     }
     readUnleashedStatus(jobName) {
         try {
-            const statusPath = path.join(BASE_DIR, 'unleashed', jobName, 'status.json');
-            if (!existsSync(statusPath))
-                return null;
-            return JSON.parse(readFileSync(statusPath, 'utf-8'));
+            const candidates = [
+                jobName,
+                jobName.startsWith('bg-') ? `bg:${jobName}` : '',
+            ].filter(Boolean);
+            for (const candidate of candidates) {
+                const safeJob = candidate.replace(/[^a-zA-Z0-9_-]/g, '_');
+                const statusPath = path.join(BASE_DIR, 'unleashed', safeJob, 'status.json');
+                if (existsSync(statusPath)) {
+                    return JSON.parse(readFileSync(statusPath, 'utf-8'));
+                }
+            }
+            return null;
         }
         catch {
             return null;
@@ -300,10 +444,14 @@ export class Gateway {
             : (task.status === 'failed' || task.status === 'aborted') && task.error
                 ? ` Reason: ${this.taskSummary(task.error, 120)}`
                 : '';
-        return `- ${task.id}: ${task.status}${phase}, ${elapsed} min${cap}. ${taskText}${terminalDetail}`;
+        const deliverable = task.status === 'done' && task.deliverableNote
+            ? ` Deliverable: ${this.taskSummary(task.deliverableNote, 120)}`
+            : '';
+        return `- ${task.id}: ${task.status}${phase}, ${elapsed} min${cap}. ${taskText}${terminalDetail}${deliverable}`;
     }
     writeUnleashedCancel(jobName) {
-        const cancelDir = path.join(BASE_DIR, 'unleashed', jobName);
+        const safeJob = (jobName.startsWith('bg-') ? `bg:${jobName}` : jobName).replace(/[^a-zA-Z0-9_-]/g, '_');
+        const cancelDir = path.join(BASE_DIR, 'unleashed', safeJob);
         mkdirSync(cancelDir, { recursive: true });
         writeFileSync(path.join(cancelDir, 'CANCEL'), '');
     }
@@ -1312,6 +1460,9 @@ export class Gateway {
                         actionExpectationSource: actionExpectationForLedger.source,
                         actionExpectationReason: actionExpectationForLedger.reason,
                         runId: ledgerRunMetadata.runId,
+                        executionMode: ledgerRunMetadata.executionMode,
+                        backgroundTaskId: ledgerRunMetadata.backgroundTaskId,
+                        skillsApplied: ledgerRunMetadata.skillsApplied,
                         permissionModeApplied: ledgerRunMetadata.permissionModeApplied,
                         allowedToolsApplied: ledgerRunMetadata.allowedToolsApplied?.slice(0, 80),
                         builtinToolsApplied: ledgerRunMetadata.builtinToolsApplied?.slice(0, 40),
@@ -1332,7 +1483,8 @@ export class Gateway {
         });
     }
     async _handleMessageInner(sessionKey, text, onText, model, maxTurns, onToolActivity, onProgress, ledgerRunMetadata) {
-        const originalText = text;
+        let originalText = text;
+        let skipBackgroundOffer = false;
         // Per-segment latency capture — emitted as a single 'chat:latency' line
         // on the happy path so we can grep/aggregate without parsing many lines.
         const tInnerStart = Date.now();
@@ -1438,6 +1590,30 @@ export class Gateway {
             }, 'chat:latency');
             return localResponse;
         }
+        const backgroundControl = this.resolveBackgroundOfferControl(sessionKey, text);
+        if (backgroundControl?.response) {
+            if (ledgerRunMetadata) {
+                ledgerRunMetadata.executionMode = backgroundControl.executionMode;
+                ledgerRunMetadata.backgroundTaskId = backgroundControl.backgroundTaskId;
+            }
+            if (onText) {
+                try {
+                    await onText(backgroundControl.response);
+                }
+                catch { /* channel streaming is best-effort */ }
+            }
+            return backgroundControl.response;
+        }
+        if (backgroundControl?.inlineText) {
+            text = backgroundControl.inlineText;
+            originalText = backgroundControl.inlineText;
+            skipBackgroundOffer = true;
+        }
+        else if (backgroundControl?.skillText) {
+            text = backgroundControl.skillText;
+            originalText = backgroundControl.skillText;
+            skipBackgroundOffer = true;
+        }
         const approvalFollowupExpected = this.isTrustedPersonalSession(sessionKey)
             && detectApprovalReply(originalText) === true
             && this.assistant.hasRecentApprovalPrompt(sessionKey);
@@ -1685,6 +1861,46 @@ export class Gateway {
                 const resolvedProfile = profileSlug
                     ? this.getAgentManager().get(profileSlug) ?? undefined
                     : undefined;
+                const isBuilderSession = sessionKey.startsWith('dashboard:builder:');
+                if (!skipBackgroundOffer && !isBuilderSession && !isInternalMsg && this.isTrustedPersonalSession(sessionKey)) {
+                    const recommendation = detectComplexTaskForBackground(text);
+                    if (recommendation) {
+                        const offer = this.createBackgroundOffer(sessionKey, text, recommendation);
+                        if (recommendation.queueImmediately) {
+                            const task = this.queueBackgroundOffer(offer);
+                            const queued = this.formatBackgroundQueuedResponse(task);
+                            if (ledgerRunMetadata) {
+                                ledgerRunMetadata.executionMode = 'background_queued';
+                                ledgerRunMetadata.backgroundTaskId = task.id;
+                            }
+                            if (onText) {
+                                try {
+                                    await onText(queued);
+                                }
+                                catch { /* channel streaming is best-effort */ }
+                            }
+                            return queued;
+                        }
+                        const offerText = this.formatBackgroundOfferResponse(offer);
+                        if (ledgerRunMetadata) {
+                            ledgerRunMetadata.executionMode = 'background_offer';
+                        }
+                        logger.info({
+                            sessionKey,
+                            offerId: offer.id,
+                            score: recommendation.score,
+                            reasons: recommendation.reasons,
+                            maxMinutes: recommendation.suggestedMaxMinutes,
+                        }, 'Offering background execution for complex chat request');
+                        if (onText) {
+                            try {
+                                await onText(offerText);
+                            }
+                            catch { /* channel streaming is best-effort */ }
+                        }
+                        return offerText;
+                    }
+                }
                 const hygiene = assessGatewayContextHygiene({
                     sessionKey: effectiveSessionKey,
                     textChars: enrichedText.length,
@@ -1804,7 +2020,6 @@ export class Gateway {
                     // the agent only emits json-artifact blocks. Strip everything
                     // expensive; keep just SDK session resume so multi-turn
                     // artifact iteration sees its own prior turns.
-                    const isBuilderSession = sessionKey.startsWith('dashboard:builder:');
                     // ── Skill auto-match (1.18.170) ─────────────────────────────
                     // Match the user's message against the skill catalog (auto-
                     // skills + user-authored). Top-3 matches above score ≥ 4 inform:
@@ -1903,7 +2118,6 @@ export class Gateway {
                         ...(chatMcp ? { extraMcpServers: chatMcp.servers } : {}),
                         onText: wrappedOnText,
                         onToolActivity: ({ tool, input }) => {
-                            toolActivityCount++;
                             if (wrappedOnToolActivity) {
                                 return wrappedOnToolActivity(tool, input);
                             }
@@ -1913,6 +2127,12 @@ export class Gateway {
                     });
                     if (ledgerRunMetadata) {
                         ledgerRunMetadata.runId = runAgentResult.runId;
+                        ledgerRunMetadata.executionMode = ledgerRunMetadata.executionMode ?? 'inline';
+                        ledgerRunMetadata.skillsApplied = resolvedSkills?.matches.map((m) => ({
+                            name: m.name,
+                            source: 'auto',
+                            score: m.score,
+                        }));
                         ledgerRunMetadata.permissionModeApplied = runAgentResult.permissionMode;
                         ledgerRunMetadata.allowedToolsApplied = runAgentResult.allowedToolsApplied;
                         ledgerRunMetadata.builtinToolsApplied = runAgentResult.builtinToolsApplied;

package/dist/gateway/turn-ledger.d.ts

@@ -17,6 +17,13 @@ export interface TurnLedgerEntry {
     actionExpectationSource?: string;
     actionExpectationReason?: string;
     runId?: string;
+    executionMode?: 'inline' | 'background_offer' | 'background_queued';
+    backgroundTaskId?: string;
+    skillsApplied?: Array<{
+        name: string;
+        source: 'auto' | 'pinned';
+        score?: number;
+    }>;
     permissionModeApplied?: string;
     allowedToolsApplied?: string[];
     builtinToolsApplied?: string[];

package/dist/gateway/turn-ledger.js

@@ -40,7 +40,12 @@ export function formatLastTurnLedger(sessionKey, baseDir = BASE_DIR) {
         ? `Tools used: ${last.toolCallsMade} (${last.toolNames.slice(0, 6).join(', ')}${last.toolNames.length > 6 ? ', ...' : ''}).`
         : 'Tools used: none.';
     const execution = last.permissionModeApplied || last.mcpServersApplied?.length
-        ? `Execution: ${last.permissionModeApplied ?? 'unknown'}${last.mcpServersApplied?.length ? `; MCP: ${last.mcpServersApplied.slice(0, 6).join(', ')}${last.mcpServersApplied.length > 6 ? ', ...' : ''}` : ''}.`
+        ? `Execution: ${last.executionMode ?? 'inline'}; ${last.permissionModeApplied ?? 'unknown'}${last.mcpServersApplied?.length ? `; MCP: ${last.mcpServersApplied.slice(0, 6).join(', ')}${last.mcpServersApplied.length > 6 ? ', ...' : ''}` : ''}.`
+        : last.executionMode
+            ? `Execution: ${last.executionMode}${last.backgroundTaskId ? ` (${last.backgroundTaskId})` : ''}.`
+            : '';
+    const skills = last.skillsApplied?.length
+        ? `Skills: ${last.skillsApplied.slice(0, 5).map((s) => s.name).join(', ')}${last.skillsApplied.length > 5 ? ', ...' : ''}.`
         : '';
     const response = last.responsePreview
         ? `Last response: "${last.responsePreview.replace(/\s+/g, ' ').slice(0, 240)}${last.responsePreview.length > 240 ? '...' : ''}"`
@@ -54,6 +59,7 @@ export function formatLastTurnLedger(sessionKey, baseDir = BASE_DIR) {
         `Toolset: ${last.toolset ?? 'auto'}.`,
         `Policy: ${last.policyReason ?? 'unknown'}; tools ${last.toolsEnabled ? 'enabled' : 'disabled'}.`,
         execution,
+        skills,
         response,
     ].filter(Boolean).join('\n');
 }

package/dist/tools/background-task-tools.js

@@ -65,6 +65,10 @@ export function registerBackgroundTaskTools(server) {
             lines.push('');
             lines.push(`Result:\n${task.result}`);
         }
+        if (task.resultPath) {
+            lines.push('');
+            lines.push(`Full result: ${task.resultPath}`);
+        }
         if (task.deliverableNote) {
             lines.push('');
             lines.push(`Deliverable: ${task.deliverableNote}`);

package/dist/types.d.ts

@@ -284,6 +284,7 @@ export interface BackgroundTask {
     startedAt?: string;
     completedAt?: string;
     result?: string;
+    resultPath?: string;
     error?: string;
     deliverableNote?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clementine-agent",
-  "version": "1.18.170",
+  "version": "1.18.172",
   "description": "Clementine — Personal AI Assistant (TypeScript)",
   "type": "module",
   "main": "dist/index.js",