@agentled/cli 0.6.7 → 0.7.2

package/dist/commands/onboarding.d.ts

@@ -1,12 +1,26 @@
 /**
- * CLI Onboarding — interactive prompts for first-time workspace setup.
+ * `agentled setup` — single canonical entrypoint for new users.
  *
- * Collects company info and calls PATCH /api/external/workspace/profile.
+ * Orchestrates the seven-step flow:
+ *   1. Version check (warns if outdated)
+ *   2. Browser sign-in + workspace selection
+ *   3. Workspace folder scaffold (agentled_<slug>/)
+ *   4. MCP auto-config (Claude Code, Codex, Cursor, Claude Desktop, Windsurf)
+ *   5. Skill install (writes SKILL.md to the client's skill directory)
+ *   6. Knowledge probe (knowledge.company.profile; if missing, prompt + write)
+ *   7. Restart prompt (printed at end of setup)
+ *
+ * Replaces the legacy `agentled setup` (company-profile-only) which required
+ * prior auth and only wrote workspace company info. The legacy company-profile
+ * prompt logic is preserved as `runOnboarding()` and called from step 6 —
+ * but it now writes to `knowledge.company.profile` (the same key the probe
+ * reads), so the prompt does not re-fire on the next run.
  */
 import { Command } from 'commander';
 /**
- * Run the onboarding flow after first login.
- * Uses the API key that was just saved to config.
+ * Interactive prompt to populate the workspace company profile. Called by
+ * step 6 of `agentled setup` when the workspace knowledge probe finds no
+ * existing `knowledge.company.profile`, and by `auth login` for new users.
  */
 export declare function runOnboarding(): Promise<void>;
 export declare function registerOnboardingCommands(program: Command): void;

package/dist/commands/onboarding.js

@@ -1,14 +1,37 @@
 /**
- * CLI Onboarding — interactive prompts for first-time workspace setup.
+ * `agentled setup` — single canonical entrypoint for new users.
  *
- * Collects company info and calls PATCH /api/external/workspace/profile.
+ * Orchestrates the seven-step flow:
+ *   1. Version check (warns if outdated)
+ *   2. Browser sign-in + workspace selection
+ *   3. Workspace folder scaffold (agentled_<slug>/)
+ *   4. MCP auto-config (Claude Code, Codex, Cursor, Claude Desktop, Windsurf)
+ *   5. Skill install (writes SKILL.md to the client's skill directory)
+ *   6. Knowledge probe (knowledge.company.profile; if missing, prompt + write)
+ *   7. Restart prompt (printed at end of setup)
+ *
+ * Replaces the legacy `agentled setup` (company-profile-only) which required
+ * prior auth and only wrote workspace company info. The legacy company-profile
+ * prompt logic is preserved as `runOnboarding()` and called from step 6 —
+ * but it now writes to `knowledge.company.profile` (the same key the probe
+ * reads), so the prompt does not re-fire on the next run.
  */
-import { AgentledClient } from '../client.js';
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
 import * as readline from 'node:readline';
+import { AgentledApiClient } from '@agentled/core';
+import { AgentledClient, getBaseUrl, saveWorkspaceProfile } from '../client.js';
+import { browserLogin } from '../utils/browser-auth.js';
+import { installSkills, getSkillsTargetDir, getCodexInstructionsDir, summarizeForLoginBanner, } from '../utils/skills.js';
+import { configureMcp, getClientLabel } from '../utils/mcp-config.js';
+import { checkCliVersion, summarizeVersionCheck } from '../utils/version-check.js';
+import { probeCompanyKnowledge, summarizeKnowledgeProbe } from '../utils/knowledge-probe.js';
+import { bootstrapAgentledHome } from '../utils/home-bootstrap.js';
+import { createWorkspaceFolder } from '../utils/workspace-folder.js';
 function prompt(question) {
     const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
-    return new Promise((resolve) => {
-        rl.question(question, (answer) => {
+    return new Promise(resolve => {
+        rl.question(question, answer => {
             rl.close();
             resolve(answer.trim());
         });
@@ -16,18 +39,13 @@ function prompt(question) {
 }
 function promptSelect(question, options) {
     const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
-    return new Promise((resolve) => {
+    return new Promise(resolve => {
         console.error(question);
         options.forEach((opt, i) => console.error(`  ${i + 1}. ${opt}`));
-        rl.question(`  Choice [1-${options.length}]: `, (answer) => {
+        rl.question(`  Choice [1-${options.length}]: `, answer => {
             rl.close();
             const idx = parseInt(answer.trim(), 10) - 1;
-            if (idx >= 0 && idx < options.length) {
-                resolve(options[idx]);
-            }
-            else {
-                resolve(options[options.length - 1]); // default to last (Other)
-            }
+            resolve(idx >= 0 && idx < options.length ? options[idx] : options[options.length - 1]);
         });
     });
 }
@@ -41,11 +59,6 @@ const USE_CASES = [
     'General process automation',
     'Other',
 ];
-/**
- * Best-effort fetch of a public website's <title> and meta description to
- * pre-populate the workspace knowledge. Failures are non-fatal — onboarding
- * continues with whatever info was collected interactively.
- */
 async function fetchSiteMetadata(rawUrl) {
     const ac = new AbortController();
     const timer = setTimeout(() => ac.abort(), 8000);
@@ -68,31 +81,32 @@ async function fetchSiteMetadata(rawUrl) {
         return null;
     }
     finally {
-        // Always clear — fast network/DNS/TLS failures otherwise leave the timer
-        // pending for up to 8s and keep the Node event loop alive, making the
-        // CLI appear to hang after onboarding finishes.
         clearTimeout(timer);
     }
 }
+function buildProfileText(company) {
+    return [
+        company.name ? `Company: ${company.name}` : null,
+        company.description ? `\n${company.description}` : null,
+        company.urls?.length ? `\nWebsite: ${company.urls.join(', ')}` : null,
+        company.additionalInformation ? `\n${company.additionalInformation}` : null,
+    ].filter(Boolean).join('\n').trim();
+}
 /**
- * Run the onboarding flow after first login.
- * Uses the API key that was just saved to config.
+ * Interactive prompt to populate the workspace company profile. Called by
+ * step 6 of `agentled setup` when the workspace knowledge probe finds no
+ * existing `knowledge.company.profile`, and by `auth login` for new users.
  */
 export async function runOnboarding() {
     console.error('\n  Welcome! Let\'s finish setting up your workspace.\n');
     const companyName = await prompt('  ? Company name: ');
     const website = await prompt('  ? Company website (optional): ');
     const useCase = await promptSelect('  ? Primary use case:', USE_CASES);
-    // Build profile payload
     const company = {};
     if (companyName)
         company.name = companyName;
     if (website)
         company.urls = [website];
-    // If a website was provided, try to read it and seed the workspace
-    // knowledge with the site's title + meta description. This populates
-    // `company.profile` knowledge text so agents have context immediately
-    // without the user having to type a description by hand.
     if (website) {
         process.stderr.write('  Reading website to seed knowledge… ');
         const meta = await fetchSiteMetadata(website);
@@ -114,40 +128,210 @@ export async function runOnboarding() {
         company.additionalInformation = additional.join('\n');
     if (Object.keys(company).length === 0) {
         console.error('\n  Skipped — no company info provided.');
-        console.error('  You can set this up later with "agentled setup".\n');
+        console.error('  You can set this up later with "agentled workspace company-profile".\n');
         return;
     }
+    // AgentledClient extends AgentledApiClient, so all KG / workspace / etc.
+    // methods are directly callable on this instance — no second client needed.
+    const cliClient = new AgentledClient();
     try {
-        const client = new AgentledClient();
-        await client.updateWorkspaceCompanyProfile(company);
-        console.error('\n  Workspace configured! ✓');
-        // Auto-seeded fields are minimal (title + meta description). Prompt the
-        // calling AI agent to do its own research and enrich the workspace
-        // knowledge so future workflows have richer context to work from.
-        console.error('\n  Agent: please research this company further and enrich the workspace.');
-        console.error('  Suggested next actions:');
-        console.error('    • Read the company website thoroughly (about/team/blog/pricing).');
-        console.error('    • Pull LinkedIn (get-linkedin-company-from-url) and recent posts.');
-        console.error('    • Use upsert_knowledge_text to store: company.profile (long-form),');
-        console.error('      company.icp (target customers), company.products, company.tone.');
-        console.error('    • Confirm the result with the user before moving on.\n');
+        await cliClient.updateWorkspaceCompanyProfile(company);
     }
     catch (err) {
-        console.error(`\n  Warning: Could not save workspace profile (${err.message}).`);
-        console.error('  You can configure it later with "agentled setup".\n');
+        console.error(`  ⚠  Could not save workspace profile record (${err.message}).`);
+    }
+    const profileText = buildProfileText(company);
+    if (profileText) {
+        try {
+            await cliClient.upsertKnowledgeText({
+                key: 'knowledge.company.profile',
+                content: profileText,
+                title: company.name || 'Company profile',
+            });
+            console.error('\n  Workspace configured! ✓ (knowledge.company.profile written)');
+        }
+        catch (err) {
+            console.error(`\n  ⚠  Could not write knowledge.company.profile (${err.message}).`);
+            console.error('  The probe will re-prompt on the next \`agentled setup\` run.');
+        }
+    }
+    console.error('\n  Next:');
+    console.error('    • Read the company website thoroughly (about/team/blog/pricing).');
+    console.error('    • Pull LinkedIn (get-linkedin-company-from-url) and recent posts.');
+    console.error('    • Use upsert_knowledge_text to enrich knowledge.company.profile (long-form),');
+    console.error('      knowledge.company.products. Skip .icp / .tone for now — add when needed.\n');
+}
+// ---------------------------------------------------------------------------
+// `agentled setup` orchestration
+// ---------------------------------------------------------------------------
+function printSection(label, step, total) {
+    console.error('');
+    console.error(`  [${step}/${total}] ${label}`);
+    console.error('');
+}
+function skillTargetForClient(client) {
+    if (client === 'claude-code' || client === 'claude-desktop') {
+        return { kind: 'claude', dir: getSkillsTargetDir(true) };
+    }
+    if (client === 'codex') {
+        return { kind: 'codex', dir: getCodexInstructionsDir() };
     }
+    return { kind: 'skip', dir: null };
+}
+async function runSetup() {
+    console.error('');
+    console.error('  ◆ Agentled Setup');
+    console.error('  One command: auth → workspace folder → MCP → skill → knowledge probe.');
+    console.error('');
+    const baseUrl = getBaseUrl().replace(/\/$/, '');
+    const TOTAL_STEPS = 7;
+    // Step 1
+    printSection('Version check', 1, TOTAL_STEPS);
+    const versionResult = await checkCliVersion();
+    const versionLine = summarizeVersionCheck(versionResult);
+    if (versionLine) {
+        console.error(`  ⚠  ${versionLine}`);
+    }
+    else {
+        console.error(`  ✓ @agentled/cli v${versionResult.installed}${versionResult.latest ? ' (latest)' : ''}`);
+    }
+    // Step 2
+    printSection('Sign in & select workspace', 2, TOTAL_STEPS);
+    const loginResult = await browserLogin(baseUrl);
+    saveWorkspaceProfile({
+        id: loginResult.workspaceId,
+        name: loginResult.workspaceName,
+        apiKey: loginResult.apiKey,
+        baseUrl: loginResult.baseUrl || baseUrl,
+        userId: loginResult.userId,
+        userEmail: loginResult.userEmail,
+        userName: loginResult.userName,
+    });
+    console.error(`  ✓ Authenticated to workspace "${loginResult.workspaceName}"`);
+    const homeBootstrap = bootstrapAgentledHome();
+    if (homeBootstrap.refreshed) {
+        console.error(`  ✓ Wrote ~/.agentled/ docs and ${homeBootstrap.scaffoldsCopied} scaffolds (content v${homeBootstrap.version})`);
+    }
+    // Step 3
+    printSection('Scaffold workspace folder', 3, TOTAL_STEPS);
+    const apiClient = new AgentledClient();
+    let folderName = null;
+    try {
+        const [workspace, appsList, modelsList] = await Promise.allSettled([
+            apiClient.getWorkspace(),
+            apiClient.listApps(),
+            apiClient.listModels(),
+        ]);
+        if (workspace.status === 'fulfilled') {
+            const ws = workspace.value;
+            const slug = String(ws.slug ?? loginResult.workspaceId.replace(/^ws_/, '') ?? 'workspace');
+            folderName = `agentled_${slug}`;
+            const folderPath = resolve(process.cwd(), folderName);
+            if (existsSync(folderPath)) {
+                console.error(`  • ${folderName}/ already exists — leaving as-is. Run \`agentled workspace sync\` to refresh.`);
+            }
+            else {
+                const meta = {
+                    workspaceId: loginResult.workspaceId,
+                    slug,
+                    name: loginResult.workspaceName,
+                    apiBase: baseUrl,
+                    syncedAt: new Date().toISOString(),
+                };
+                createWorkspaceFolder(folderPath, meta, {
+                    appsList: appsList.status === 'fulfilled' ? appsList.value : undefined,
+                    modelsList: modelsList.status === 'fulfilled' ? modelsList.value : undefined,
+                });
+                console.error(`  ✓ Created ${folderName}/ in current directory`);
+            }
+        }
+        else {
+            console.error(`  ⚠  Could not load workspace metadata (${workspace.reason?.message ?? 'unknown'}). Run \`agentled init\` later.`);
+        }
+    }
+    catch (err) {
+        console.error(`  ⚠  Folder scaffold skipped (${err?.message ?? err}). Run \`agentled init\` later.`);
+    }
+    // Step 4
+    printSection('Configure MCP client', 4, TOTAL_STEPS);
+    const mcpResult = await configureMcp(loginResult.apiKey, loginResult.baseUrl || baseUrl);
+    if (mcpResult.success) {
+        console.error(`  ✓ Registered "agentled" MCP server in ${getClientLabel(mcpResult.client)}${mcpResult.configPath ? ` (${mcpResult.configPath})` : ''}`);
+    }
+    else if (mcpResult.fallbackHint) {
+        console.error(`  ⚠  Could not auto-configure MCP. Manual instructions:`);
+        console.error('');
+        for (const line of mcpResult.fallbackHint.split('\n'))
+            console.error(`    ${line}`);
+    }
+    // Step 5
+    printSection('Install Agentled skill', 5, TOTAL_STEPS);
+    const skillTarget = skillTargetForClient(mcpResult.client);
+    if (skillTarget.kind === 'skip') {
+        console.error(`  • Skill auto-install not supported for ${getClientLabel(mcpResult.client)} — skipped.`);
+        console.error(`    Run \`agentled skills install\` if your client supports Claude-format skills.`);
+    }
+    else {
+        try {
+            const results = installSkills({ targetDir: skillTarget.dir });
+            const banner = summarizeForLoginBanner(results, skillTarget.dir);
+            if (banner) {
+                console.error(`  ✓ ${banner}`);
+            }
+            else {
+                console.error(`  • Skill already installed in ${skillTarget.dir}`);
+            }
+        }
+        catch (err) {
+            console.error(`  ⚠  Skill install skipped (${err?.message ?? err}). Run \`agentled skills install\` later.`);
+        }
+    }
+    // Step 6 — the probe explicitly uses loginResult.apiKey/baseUrl rather
+    // than the saved-config-resolved `apiClient`, so a stale AGENTLED_API_KEY
+    // env var pointing at a different workspace cannot mask the
+    // just-authenticated workspace's knowledge.
+    printSection('Probe workspace knowledge', 6, TOTAL_STEPS);
+    const probe = await probeCompanyKnowledge(new AgentledApiClient({
+        apiKey: loginResult.apiKey,
+        baseUrl: loginResult.baseUrl || baseUrl,
+        missingAuthMessage: 'API key is required.',
+    }));
+    console.error(`  ${probe.profilePresent ? '✓' : '•'} ${summarizeKnowledgeProbe(probe)}`);
+    if (!probe.profilePresent && !probe.error) {
+        await runOnboarding();
+    }
+    // Step 7
+    printSection('Restart your MCP client', 7, TOTAL_STEPS);
+    console.error('  Your MCP client must restart to pick up the new connection:');
+    console.error('    • Claude Code: /mcp → reconnect, or restart the session');
+    console.error('    • Codex / Cursor: quit and reopen the app');
+    console.error('');
+    console.error('  ——— Setup complete ———');
+    console.error('');
+    if (folderName) {
+        console.error(`  Workspace folder: ./${folderName}/`);
+    }
+    console.error('  Global home:      ~/.agentled/  (config, docs, scaffolds)');
+    console.error('');
+    console.error('  Try: "agentled --help" or talk to your agent.');
+    console.error('');
 }
 export function registerOnboardingCommands(program) {
     program
         .command('setup')
-        .description('Set up workspace profile (company name, website, use case)')
+        .description('Connect Agentled end-to-end: auth → workspace folder → MCP → skill → knowledge probe')
         .action(async () => {
-        const client = new AgentledClient();
-        if (!client.isAuthenticated) {
-            console.error('Not authenticated. Run "agentled auth login" first.');
+        try {
+            await runSetup();
+        }
+        catch (err) {
+            console.error(`\n  ✗ Setup failed: ${err?.message ?? err}`);
+            console.error('  You can re-run \`agentled setup\`, or run components individually:');
+            console.error('    agentled auth login        # browser auth');
+            console.error('    agentled init              # workspace folder');
+            console.error('    agentled skills install    # install Claude Code skill');
             process.exit(1);
         }
-        await runOnboarding();
     });
 }
 //# sourceMappingURL=onboarding.js.map

package/dist/commands/onboarding.js.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../src/commands/onboarding.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../src/commands/onboarding.ts"],"names":[],"mappings":"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"}

package/dist/utils/agentled-home-content.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Bundled docs written into `~/.agentled/docs/` on `agentled setup` runs.
+ *
+ * Embedded as string constants so they ship with the CLI release (same
+ * pattern as GOTCHAS.md in workspace-folder.ts).
+ *
+ * **`docs/` is CLI-managed.** Treat the bundled files as read-only — they
+ * are unconditionally rewritten when `HOME_CONTENT_VERSION` advances
+ * past the on-disk marker. Anyone who wants to edit local notes should
+ * put them in `~/.agentled/docs/local/` (never touched by the bootstrap)
+ * or in the per-workspace `agentled_<slug>/` folder.
+ *
+ * `HOME_CONTENT_VERSION` is intentionally **decoupled from the CLI
+ * package version** — it is an opaque integer that bumps only when one
+ * of the constants below changes. A CLI patch bump that touches no doc
+ * content does not refresh `~/.agentled/`.
+ */
+/**
+ * Bump this every time any HOME_README_MD / WORKFLOW_SHAPE_MD /
+ * GETTING_STARTED_MD / GOTCHAS_MD / PATTERNS_MD constant changes.
+ *
+ * Do NOT pin to the CLI semver — that bumps for unrelated reasons and
+ * causes spurious doc rewrites on every patch release.
+ */
+export declare const HOME_CONTENT_VERSION = "3";
+export declare const HOME_README_MD = "# AgentLed\n\nYou've installed the AgentLed CLI. Your AI agent (Claude Code, Codex, Cursor, Claude Desktop, Windsurf) can now build and run workflows for you.\n\n## Talk to your agent\n\nOnce `agentled setup` is done and you've restarted your MCP client, just describe what you want. The agent has access to AgentLed's MCP tools, your workspace's knowledge graph, and 100+ integrations.\n\nTry one:\n- \"Source fintech CTOs in Europe via search and LinkedIn, score by ICP fit, email me the top 10 daily.\"\n- \"Qualify inbound form submissions and route the high-score ones to a Slack channel.\"\n- \"Pull competitor pricing pages weekly, summarize changes, send a diff report.\"\n\n## What lives here\n\n- `config.json` \u2014 saved workspace profiles (managed by `agentled auth`).\n- `docs/` \u2014 brief design guide your agent reads on session start. **CLI-managed: treat as read-only.** Files here are rewritten when the bundled doc version advances.\n- `docs/local/` \u2014 your own notes. **Never overwritten by the CLI.** Put any edits or additions here.\n- `examples/scaffolds/` \u2014 preflight-clean pipeline templates your agent adapts to your intent. Also CLI-managed.\n\nPer-workspace artifacts (logs, dryruns, decisions, drafts) live in `agentled_<workspace-slug>/` in your project directory \u2014 one folder per workspace.\n\n## CLI commands\n\n```\nagentled --help              # list commands\nagentled auth current        # active workspace\nagentled workflows list      # workflows in your workspace\nagentled examples            # browse pattern templates\n```\n\n## Open patterns reference\n\nFor extended workflow patterns and anti-patterns beyond the bundled scaffolds, see the public agentic-ops repo: https://github.com/Agentled/agentic-ops. Optional reading \u2014 the bundled `docs/` and `examples/scaffolds/` are sufficient for first-workflow building.\n";
+export declare const WORKFLOW_SHAPE_MD = "# Workflow shape \u2014 source \u2192 list \u2192 orchestrator \u2192 outreach\n\nThe canonical AgentLed workflow shape, optimized for re-runnable, dedup-safe pipelines.\n\n## The list is the spine\n\nA KG list (e.g. `kg.list.leads`) holds every entity your business cares about. Multiple sourcing workflows write into the same list. One orchestrator workflow reads from it, processes, and transitions row state.\n\nTwo indexes make this efficient:\n\n1. **`userKey`** \u2014 caller-supplied dedup index. Use a stable identifier per row (domain, LinkedIn URL, email hash). `kg.upsert-rows` with the same `userKey` writes to the same row, every time, forever. No table scan, no duplicate explosion.\n2. **`status`** \u2014 the queue marker. New rows start at `status: \"new\"`. The orchestrator filters by status, processes only rows in the relevant state, and transitions status as it goes (`scored`, `qualified`, `contacted`, `rejected`).\n\n## Sourcing workflows (1+)\n\nEach sourcing workflow has one job: find entities, write them with a `userKey` and `status: \"new\"`. Use `mergeStrategy: \"merge\"` so downstream-added fields (scores, notes) survive a re-source. Many sourcing workflows can write to the same list.\n\n```json\n{\n  \"id\": \"save-to-list\",\n  \"type\": \"appAction\",\n  \"app\": { \"id\": \"kg\", \"actionId\": \"kg.upsert-rows\", \"source\": \"native\" },\n  \"stepInputData\": {\n    \"listKey\": \"leads\",\n    \"rows\": \"{{steps.extract.items}}\",\n    \"mergeStrategy\": \"merge\",\n    \"status\": \"new\"\n  }\n}\n```\n\n> Note: pass `rows` directly as the template variable \u2014 do NOT wrap it in `JSON.stringify` or quote-escape the array. The serializer inlines the raw value (see GOTCHAS.md #12). The `filters` field on `kg.read-list` (below) is the exception \u2014 it expects a JSON-string body, not an array, so the escaped object literal is correct there.\n\n## Orchestrator workflow (1)\n\nSchedule trigger \u2192 `kg.read-list` filtered by `status: \"new\"` \u2192 loop \u2192 score / qualify / route \u2192 `kg.update-rows` to transition status.\n\n```json\n// Step 1: read pending rows\n{\n  \"id\": \"read-pending\",\n  \"type\": \"appAction\",\n  \"app\": { \"id\": \"kg\", \"actionId\": \"kg.read-list\", \"source\": \"native\" },\n  \"stepInputData\": { \"listKey\": \"leads\", \"filters\": \"{\\\"status\\\": \\\"new\\\"}\", \"limit\": \"50\" }\n}\n\n// Step N: transition status\n{\n  \"id\": \"mark-scored\",\n  \"type\": \"appAction\",\n  \"app\": { \"id\": \"kg\", \"actionId\": \"kg.update-rows\", \"source\": \"native\" },\n  \"stepInputData\": {\n    \"listKey\": \"leads\",\n    \"rowIds\": \"{{steps.score.processedIds}}\",\n    \"fieldUpdates\": \"{\\\"status\\\": \\\"scored\\\"}\"\n  }\n}\n```\n\n## Outreach workflow (1, optional)\n\nOften folded into the orchestrator. When separate: schedule trigger \u2192 `kg.read-list` filtered by `status: \"qualified\"` \u2192 compose email (with approval gate) \u2192 `schedule-email` \u2192 mark `status: \"contacted\"`.\n\nWhy separate: outreach has different cadence (e.g. daily, batch-limited) than scoring (continuous), and you may want different approval gates per channel.\n\n## Status conventions\n\n| Value | Meaning |\n|-------|---------|\n| `new` | Sourced, not yet processed |\n| `scored` | Enriched + scored, awaiting routing |\n| `qualified` | Passes ICP / threshold, ready for outreach |\n| `rejected` | Failed scoring criteria |\n| `contacted` | Outreach sent |\n| `replied` | Reply received (set by an inbound workflow) |\n\nUse whatever values fit your domain. The pattern is: sourcing always sets one status, the orchestrator transitions through \u22651 status, reads always filter by status.\n\n## Why the spine matters\n\n- Multiple sourcing channels converge \u2014 one canonical list, no fan-out logic in each producer.\n- Re-running a source is idempotent \u2014 `userKey` dedup.\n- Re-running the orchestrator is idempotent \u2014 status filter excludes done rows.\n- Each phase has its own cadence \u2014 sourcing daily, orchestrator hourly, outreach business hours.\n- Failures are scoped \u2014 a bad source doesn't pollute scoring; a bad scorer doesn't break sourcing.\n\n## Pausing for human input \u2014 decouple via the list\n\nWhen a workflow needs human input partway through (e.g., \"meeting done, capture the outcome and transcript URL, then continue scoring\"), **don't try to pause inside one workflow**. Split it across the KG list spine \u2014 same shape as everything else.\n\n```\nWorkflow A (the producer)\n  \u2026 reaches the point that needs human input \u2026\n  \u2192 kg.update-rows: status = \"needs-meeting-outcome\"\n  \u2192 milestone (A is done; row sits in the list)\n\nWorkflow B (user-triggered, manual)\n  \u2192 trigger: manual, with input page asking for:\n        - meeting_outcome (text)\n        - transcript_url   (url)\n  \u2192 kg.update-rows: status = \"input-received\", fieldUpdates = { outcome, transcript }\n  \u2192 milestone\n\nWorkflow C (the consumer, scheduled)\n  \u2192 kg.read-list filtered by status = \"input-received\"\n  \u2192 \u2026 continue scoring / qualifying using outcome + transcript \u2026\n  \u2192 kg.update-rows: status = \"scored\"\n```\n\nWhy decouple:\n- Each workflow has its own cadence and trigger \u2014 the producer runs on schedule, the user-triggered B runs whenever the user has the data, the consumer runs on schedule. None blocks the other.\n- The KG row carries the state. If the user fills in the form a week later, it just works \u2014 nothing was hanging in memory waiting.\n- A new agent (or a teammate) can act on rows in any state at any time \u2014 the substrate is shared.\n- You can have multiple producers, multiple human-input forms (different roles, different channels), and one consumer. Or any other shape that fits.\n\nIn-workflow pause-with-input is possible in some cases via `milestone` with a configured input page, but the AgentLed-native approach for human-in-the-loop is the decoupled pattern above. Reach for it first.\n\n## Where to put what\n\n| You want to\u2026 | Use |\n|--------------|-----|\n| Capture per-execution input from a user | `context.inputPages` on the workflow |\n| Capture per-execution input from a public form / unauthed user | a workflow with a public form trigger and a public-form share configuration |\n| Reference workspace-wide context (ICP, tone, products, brand voice) | `knowledge.* text` (read via `kg.read-text`, written via `kg.upsert-text`) \u2014 shared across workflows and agents |\n| Hand a result back to the user as a viewable report | `aiAction` (structured output) \u2192 renderer config on that step \u2192 `share` step (creates URL) \u2192 email notification with the URL |\n| Pause one workflow until a human provides extra data | Split into two workflows + a status transition on the KG row (see \"Pausing for human input\" above) |\n| Track business value once a workflow is validated | `metadata.roi` + `eventSummary` per run + an `entryConditions` gate that skips the run when inputs wouldn't move the needle |\n\n### Report-and-share-back sequence\n\nThe canonical \"give me a report and email me a link\" sequence:\n\n```json\n// Step 1: aiAction with structured output the renderer can read\n{\n  \"id\": \"compose-report\",\n  \"type\": \"aiAction\",\n  \"pipelineStepPrompt\": {\n    \"template\": \"\u2026 build the report here \u2026\",\n    \"responseStructure\": { \"title\": \"string\", \"sections\": [{ \"heading\": \"string\", \"body\": \"string\" }] }\n  },\n  \"renderer\": { \"type\": \"Config\", \"config\": { \"layout\": \"report\" } },\n  \"creditCost\": 20,\n  \"next\": { \"stepId\": \"make-share\" }\n}\n\n// Step 2: share step \u2192 mints a public URL pointing at compose-report's output\n{\n  \"id\": \"make-share\",\n  \"type\": \"share\",\n  \"shareConfig\": { \"outputSteps\": [\"compose-report\"], \"visibility\": \"link\" },\n  \"next\": { \"stepId\": \"notify\" }\n}\n\n// Step 3: email notification with the share URL inlined\n{\n  \"id\": \"notify\",\n  \"type\": \"aiAction\",\n  \"pipelineStepPrompt\": {\n    \"type\": \"email\",\n    \"template\": \"Draft a 2-line email letting the user know their report is ready. Include the link.\",\n    \"responseStructure\": {\n      \"email\": {\n        \"from\": \"{{context.outreachProfile.fromEmail}}\",\n        \"to\": \"{{input.recipient_email}}\",\n        \"subject\": \"Your report is ready\",\n        \"body\": \"<p>Your report: <a href=\\\"{{steps.make-share.url}}\\\">view it here</a>.</p>\",\n        \"bodyType\": \"html\"\n      }\n    }\n  },\n  \"onApproval\": { \"action\": \"schedule-email\" },\n  \"next\": { \"stepId\": \"done\" }\n}\n```\n\n### Public input pattern\n\nFor workflows triggered by user-submitted forms (no auth required), use a public-form trigger and a share configuration that exposes the form at a stable slug. The form's submission payload becomes the workflow input. Same workflow shape applies; only the trigger differs.\n\n### Post-validation: ROI + business metrics\n\nOnce a workflow is validated and running:\n\n1. **ROI tracking** \u2014 add an `metadata.roi` block with hours saved per run, dollar value, conversion lift. Surfaces in the workflow header and the workspace metrics dashboard.\n2. **Per-run `eventSummary`** \u2014 emit a small structured log: count processed, count qualified, total credits, success rate. Powers the metrics dashboard and lets agents reason about workflow health from the KG.\n3. **`entryConditions` gate** \u2014 skip the run when its inputs wouldn't actually move the needle (e.g., `kg.read-list` returned 0 new rows, or upstream signal is below threshold). Avoids credit waste on no-op runs and produces cleaner ROI numbers.\n\nFull pattern reference (step types, schemas, all gotchas) is in the AgentLed skill loaded into your AI agent on session start.\n";
+export declare const GETTING_STARTED_MD = "# Your first end-to-end workflow\n\nFive minutes from \"I have an idea\" to \"my agent built it\".\n\n## 1. Describe intent in one sentence\n\nGood prompts look like:\n\n- \"Source 50 fintech startups in Europe via search, write them to a leads list, score by ICP fit, and email me the top 10 weekly.\"\n- \"When a form is submitted, qualify against my ICP knowledge and post the high-score ones to #sales-qualified in Slack.\"\n\nBad prompts look like:\n\n- \"Build me a CRM.\" (Too broad \u2014 the agent doesn't know what to start with.)\n- \"Use aiAction with workspace_memory tool.\" (Too prescriptive \u2014 you're authoring the pipeline, not the agent.)\n\n## 2. Let the agent orient\n\nThe agent will run `workspace inspect` (or the equivalent MCP tools) to look at:\n\n- Your existing KG lists (so it can reuse rather than create duplicates).\n- Connected apps (LinkedIn, Hunter, Gmail, Slack \u2014 only what's authed will work).\n- Existing workflows (it won't recreate one you already have).\n- Existing agents and routines.\n\nThis usually triggers 1-3 short questions back. Answer them and move on.\n\n## 3. Build incrementally\n\nThe agent will start from a scaffold (one of `~/.agentled/examples/scaffolds/*.json`), adapt it to your intent, and add steps one at a time. Per-step validation catches type mismatches, bad model IDs, and template-variable typos before the full workflow is saved.\n\nDo not ask the agent to dump a 30-step JSON in one shot. The skill explains why.\n\n## 4. Validate, then run small\n\n```\nagentled workflows validate <workflowId>      # graph-level checks\nagentled workflows lint <file.json>           # static gotcha catches\n```\n\nFirst execution: feed it 3-5 sample inputs, not 500. Watch the credit count. If something is wrong, fix it cheap.\n\n## 5. Promote to production\n\n```\nagentled workflows publish <workflowId> --status live\n```\n\nThen schedule it (or trigger it manually, or wire it to a webhook). Iterate.\n\n## What good looks like\n\n- Sourcing on its own schedule, writing to a list with `userKey` dedup.\n- An orchestrator that filters by `status` so it never re-processes done rows.\n- Every branch terminates (`milestone` for top-level workflows, `return` for child workflows, or no `next.stepId`). `milestone` is a labeled endpoint, not a required step \u2014 a workflow with no `next` is already terminal.\n- Human-in-the-loop steps decoupled across workflows via the KG list (see WORKFLOW-SHAPE.md \"Pausing for human input\").\n- An outreach step (or workflow) gated on approval before sending.\n- ROI metadata + `eventSummary` + an `entryConditions` gate \u2014 added once the workflow is validated.\n\nFor the canonical shape and the \"where to put what\" reference, see `WORKFLOW-SHAPE.md` in this folder. For silent failure modes see `GOTCHAS.md`.\n";
+export declare const GOTCHAS_MD = "# AgentLed \u2014 documented silent failure modes\n\nThese pass JSON syntax validation but silently misbehave at runtime.\nRun `agentled workflows lint <file>` to catch them statically before deploying.\n\n---\n\n## 1. `criteria` not `conditions` in entryConditions\n\n**Wrong:** `{ \"entryConditions\": { \"conditions\": [...] } }`\n**Correct:** `{ \"entryConditions\": { \"criteria\": [...] } }`\n\nThe executor reads `entryConditions.criteria`. The key `conditions` is silently ignored.\n\n## 2. `variable` not `field` in criteria items\n\n**Wrong:** `{ \"field\": \"{{steps.x.score}}\", \"operator\": \">\", \"value\": 70 }`\n**Correct:** `{ \"variable\": \"{{steps.x.score}}\", \"operator\": \">\", \"value\": 70 }`\n\nUsing `field` causes the criterion to be silently skipped.\n\n## 3. Gmail label_id must be the internal Label_XXXX ID\n\nGmail's API requires `Label_XXXXXXXXXX` IDs, not display names. Add a `GMAIL_CREATE_LABEL` step before and use `{{steps.ensure-label.id}}`.\n\n## 4. `aiActionWithTools` with no tools\n\nA step with `type: \"aiActionWithTools\"` must have at least one tool in `step.tools` or `step.agent.tools`. Valid `builtinType` values: `web_search`, `file_search`, `code_interpreter`, `fetch_website_content`, `kg_search`, `kg_traverse`, `kg_nodes`, `kg_write`, `workspace_memory`.\n\n## 5. Email steps need type + approval action + outreachProfile\n\nThree required pieces:\n- `pipelineStepPrompt.type: \"email\"`\n- `onApproval.action: \"schedule-email\"`\n- `outreachProfile` input page in `context.inputPages`\n\nMissing the schedule-email action means the email is drafted but never sent.\n\n## 6. Only the first step in a loop gets `loopConfig`\n\n`loopConfig` must be on the first step in the loop chain only. Subsequent steps inside the loop iterate automatically.\n\n## 7. Don't pass raw `{{input.*}}` directly to search APIs\n\nAdd an aiAction step before the search that generates optimized queries. Raw user input makes poor search queries.\n\n## 8. Child workflows use `return`; `internal: true` is for child-only workflows\n\nIf a workflow is called via `agentled.call-workflow` (i.e., a **child workflow** invoked by another workflow rather than a user), use `type: \"return\"` instead of `milestone`. `milestone` produces no return data \u2014 the parent receives nothing.\n\nAlso set `context.executionInputConfig.internal: true` on the **child** workflow \u2014 this hides it from the user-triggered list.\n\n**Top-level workflows** triggered directly by users (manual, schedule, webhook, public form, app event) keep `milestone` and **do NOT** set `internal: true`. Setting `internal: true` on a user-facing workflow hides it from its intended caller.\n\n## 9. Model IDs are internal format, not Anthropic format\n\nWrong: `claude-sonnet-4-6`. Correct: `claude-4-6-sonnet`. Run `agentled models list` for valid internal IDs.\n\n## 10. Native app actionId must include appId prefix\n\nWrong: `{ \"id\": \"kg\", \"actionId\": \"read-list\" }`\nCorrect: `{ \"id\": \"kg\", \"actionId\": \"kg.read-list\" }`\n\n## 11. `loop_completion` criteria requires `onCriteriaFail: \"wait\"`\n\nWithout `onCriteriaFail: \"wait\"`, the step skips instead of blocking until the loop finishes. The `stepId` field is also required.\n\n## 12. Arrays in JSON template strings \u2014 don't JSON.stringify\n\nThe serializer detects when a template variable is the sole content of a JSON field and inlines the raw value. Pass `{ \"items\": \"{{steps.x.items}}\" }` directly \u2014 no stringify needed. (Note: `kg.read-list` `filters` is the exception \u2014 it expects a JSON-string body, see WORKFLOW-SHAPE.md.)\n\n## 13. `kg.upsert-rows` needs `userKey` for dedup; `kg.add-rows` always inserts\n\n`kg.upsert-rows` with `userKey`: same key = same row, cross-run dedup O(1).\n`kg.add-rows`: always inserts a new row, duplicates accumulate.\nUse `mergeStrategy: \"merge\"` to preserve downstream-added fields.\n";
+export declare const PATTERNS_MD = "# Pattern index \u2014 `~/.agentled/examples/scaffolds/`\n\nPreflight-clean pipeline templates. Pick the closest match to your intent and adapt \u2014 don't author from scratch.\n\n| Scaffold | Shape | Use when |\n|----------|-------|----------|\n| `minimal.json` | trigger \u2192 milestone | smoke-testing the pipeline runner |\n| `email-polling-dedup.json` | schedule \u2192 fetch emails (label dedup) \u2192 loop \u2192 add label | inbound email triage / processing without double-handling |\n| `lead-scoring-kg.json` | trigger \u2192 `kg.read-list` \u2192 AI scoring loop \u2192 `knowledgeSync` | the orchestrator phase of source \u2192 list \u2192 orchestrator |\n| `list-match-email.json` | trigger \u2192 `kg.read-list` \u2192 AI match \u2192 composed email (approval gate) \u2192 `knowledgeSync` | outreach phase: pull qualified rows, draft email, gate on approval |\n| `extract-threshold-alert.json` | trigger \u2192 AI extract \u2192 threshold check \u2192 external update \u2192 conditional Slack \u2192 `knowledgeSync` | conditional routing on AI-extracted scores |\n| `ai-with-tools.json` | trigger \u2192 `aiActionWithTools` (web_search + workspace_memory) \u2192 milestone | starter for agentic steps that need to call runtime tools |\n\n## Mapping to the canonical shape\n\nThe `source \u2192 list \u2192 orchestrator \u2192 outreach` flow uses these scaffolds in combination:\n\n- **Sourcing** (1+ workflows feeding the same list): start from a scaffold that ends in `kg.upsert-rows` to your list, with `userKey` and `status: \"new\"`. The bundled `email-polling-dedup` is the closest starter; adapt the source step to your channel (search, scrape, form, webhook).\n- **Orchestrator** (reads pending status, processes, transitions): start from `lead-scoring-kg` and add a final `kg.update-rows` step that sets `status: \"scored\"` (or `qualified` / `rejected`).\n- **Outreach** (reads qualified, sends with approval): start from `list-match-email`, then add the `kg.update-rows` to mark `status: \"contacted\"`.\n- **Reports** (generate output, share, notify): see the \"Report-and-share-back sequence\" section in `WORKFLOW-SHAPE.md` \u2014 `aiAction` \u2192 `share` step \u2192 email notification.\n- **Human-in-the-loop** (workflow needs human input partway through): see \"Pausing for human input\" in `WORKFLOW-SHAPE.md` \u2014 split into producer + manual-trigger input form + consumer, all keyed on a status transition in the KG row.\n\nFor the full pattern shape and why `userKey` + `status` matter as indexes, see `WORKFLOW-SHAPE.md` in this folder.\n";