@agentled/cli 0.6.6 → 0.7.1

package/dist/utils/version-check.js

@@ -0,0 +1,77 @@
+/**
+ * Best-effort "new version available" check against the npm registry.
+ *
+ * Compares the locally-installed @agentled/cli version (from package.json)
+ * against the latest published on npm and prints a one-line warning if the
+ * user is behind. Never blocks setup on failure — a flaky network or
+ * registry should not prevent first-time onboarding.
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const REGISTRY_URL = 'https://registry.npmjs.org/@agentled/cli/latest';
+const TIMEOUT_MS = 3000;
+/**
+ * Read the version field from this package's own package.json. Returns
+ * '0.0.0-dev' as a fallback so a missing/unreadable file doesn't crash setup.
+ */
+export function getInstalledCliVersion() {
+    try {
+        const here = fileURLToPath(import.meta.url);
+        // dist/utils/version-check.js → package root is two levels up
+        const pkgRoot = resolve(dirname(here), '..', '..');
+        const pkg = JSON.parse(readFileSync(resolve(pkgRoot, 'package.json'), 'utf-8'));
+        return typeof pkg.version === 'string' ? pkg.version : '0.0.0-dev';
+    }
+    catch {
+        return '0.0.0-dev';
+    }
+}
+/** Compare two semver-ish strings: -1, 0, 1. Prerelease suffixes are ignored. */
+function compareVersions(a, b) {
+    const parse = (v) => v.replace(/^v/, '').split('-')[0].split('.').map(n => parseInt(n, 10) || 0);
+    const [a1, a2 = 0, a3 = 0] = parse(a);
+    const [b1, b2 = 0, b3 = 0] = parse(b);
+    if (a1 !== b1)
+        return a1 < b1 ? -1 : 1;
+    if (a2 !== b2)
+        return a2 < b2 ? -1 : 1;
+    if (a3 !== b3)
+        return a3 < b3 ? -1 : 1;
+    return 0;
+}
+export async function checkCliVersion() {
+    const installed = getInstalledCliVersion();
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), TIMEOUT_MS);
+    try {
+        const res = await fetch(REGISTRY_URL, { signal: ac.signal });
+        if (!res.ok) {
+            return { installed, latest: null, outdated: false, error: `HTTP ${res.status}` };
+        }
+        const data = (await res.json());
+        const latest = typeof data.version === 'string' ? data.version : null;
+        if (!latest) {
+            return { installed, latest: null, outdated: false, error: 'No version field in registry response' };
+        }
+        return {
+            installed,
+            latest,
+            outdated: compareVersions(installed, latest) < 0,
+        };
+    }
+    catch (err) {
+        return { installed, latest: null, outdated: false, error: err?.message ?? String(err) };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** One-line summary suitable for the setup banner. Returns null if there is nothing to say. */
+export function summarizeVersionCheck(r) {
+    if (r.outdated && r.latest) {
+        return `New @agentled/cli version available: v${r.installed} → v${r.latest}. Update with: npm install -g @agentled/cli@latest`;
+    }
+    return null;
+}
+//# sourceMappingURL=version-check.js.map

package/dist/utils/version-check.js.map

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

package/llms-full.txt

@@ -117,6 +117,18 @@ agentled executions stop <workflow-id> <execution-id>
 # Pause / Resume an execution
 agentled executions pause <workflow-id> <execution-id>
 agentled executions resume <workflow-id> <execution-id>
+
+# Admin-only surgical patch commands (require API key with admin:patch scope)
+agentled executions patch-timeline-fields <workflow-id> <execution-id> <timeline-id> \
+  --reason "Fix malformed pending email subject" \
+  --expected-updated-at "2026-05-05T10:00:00.000Z" \
+  --patches '[{"op":"replace","path":"eventContent.email.subject","value":"Updated subject"}]' \
+  --dry-run
+
+agentled executions patch-execution-fields <workflow-id> <execution-id> \
+  --reason "Clarify execution name during incident review" \
+  --expected-updated-at "2026-05-05T10:00:00.000Z" \
+  --patches '[{"op":"replace","path":"metadata.executionName","value":"Recovered test run"}]'
 ```
 
 ### Apps & Actions
@@ -444,6 +456,7 @@ External API endpoints for programmatic approve/reject are planned.
 In the meantime, agents can:
 - Check execution status: `agentled executions get <wf-id> <exec-id>` — look for `status: "pending"` timelines
 - Pause/resume: `agentled executions pause/resume <wf-id> <exec-id>`
+- For exceptional admin recovery only, use `agentled executions patch-timeline-fields` or `agentled executions patch-execution-fields` with an `admin:patch` API key, a fresh `updatedAt` value, and either `--patches` or `--patches-file`.
 
 ---
 

package/llms.txt

@@ -4,9 +4,20 @@
 
 ## Quick Start
 
+One command: browser sign-in → workspace folder → MCP auto-config → skill install → knowledge probe.
+
+```bash
+npx @agentled/cli setup
+```
+
+Global home is `~/.agentled/` (config + on-demand examples). Per-workspace artifacts live in `agentled_<slug>/` in the current directory. Best-practice patterns: https://github.com/Agentled/agentic-ops.
+
+## Components (à-la-carte)
+
 ```bash
 npm i -g @agentled/cli
-agentled auth login
+agentled auth login            # browser auth + workspace selection + skill install
+agentled init                   # scaffold agentled_<slug>/
 agentled auth current
 agentled workflows list
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentled/cli",
-  "version": "0.6.6",
+  "version": "0.7.1",
   "description": "CLI for Agentled — manage workflows, apps, and knowledge from the command line. Zero context-window cost for AI agents.",
   "type": "module",
   "main": "dist/index.js",
@@ -47,10 +47,10 @@
   "homepage": "https://www.agentled.app",
   "repository": {
     "type": "git",
-    "url": "https://github.com/agentled/agentled"
+    "url": "https://github.com/agentled/mcp-server"
   },
   "bugs": {
-    "url": "https://github.com/agentled/agentled/issues"
+    "url": "https://www.agentled.ai/en/contact-us"
   },
   "license": "MIT"
 }

package/skills/agentled/SKILL.md

@@ -54,7 +54,7 @@ Every pipeline step **must** set `type` to one of these values. Any other value
 | `aiAction` | LLM prompt → structured JSON output | `{ id, type: "aiAction", name, pipelineStepPrompt: { template, responseStructure }, creditCost, next: { stepId } }` |
 | `aiActionWithTools` | LLM agent that can invoke runtime tools (web_search, workspace_memory, app actions) | `{ id, type: "aiActionWithTools", name, tools: [{ builtinType }], pipelineStepPrompt: {…}, next: { stepId } }` |
 | `toolAction` | Direct tool/webhook invocation (no LLM) | `{ id, type: "toolAction", name, tool: {…}, next: { stepId } }` |
-| `code` | Run JS/Python in a sandbox | `{ id, type: "code", name, codeConfig: { language: "javascript", code: "…" }, next: { stepId } }` |
+| `code` | Run JS/Python in a sandbox | `{ id, type: "code", name, codeConfig: { language: "javascript", code: "…", responseStructure?: { field: "type" } }, next: { stepId } }` |
 | `setVariables` | Deterministic expression → named output mapping (branch convergence, no LLM/credits) | `{ id, type: "setVariables", name, setVariablesConfig: { variables: [{ name, expression }] }, next: { stepId } }` |
 | `knowledgeSync` | Deterministic KG field mapping & link writing | `{ id, type: "knowledgeSync", name, knowledgeSync: { source, listKey, fieldMapping }, next: { stepId } }` |
 | `return` | Terminal step for **child** workflows — returns data to the caller | `{ id, type: "return", name, returnConfig: { fields: [{ name, stepId, field }] } }` |
@@ -114,6 +114,21 @@ agentled best-practices                             # summary + link to agentic-
 
 Full patterns are maintained publicly at https://github.com/agentled/agentic-ops — the CLI ships a mirrored copy, see `agentled examples`. Scaffolds are preflight-clean pipeline JSON skeletons; start from one instead of writing from scratch.
 
+## Business metrics vs ROI (must not be conflated)
+
+Treat these as **two separate surfaces**:
+
+- **Business metrics (`pipeline.analyticsConfig`)** = customer/workflow outcome stats extracted from step outputs (volume, conversions, approvals, rates, SLA-ish KPIs), aggregated into dashboard business-metric snapshots.
+- **ROI (`pipeline.metadata.roi`)** = economic assumptions + rollups (minutes saved per unit, hourly rate, benchmark units/week, measured vs benchmark mode) used for ROI/time-saved reporting.
+
+### Required wording for agent outputs
+
+- If only `analyticsConfig` changes: say **"business metrics configured"**.
+- If only `metadata.roi` changes: say **"ROI assumptions configured"**.
+- If both change: report each section separately; never label analytics metrics as ROI metrics.
+
+This distinction applies to MCP and CLI users equally because both surfaces call the same external workflow API and return the same pipeline shape.
+
 ## Common invalid patterns to avoid
 
 Agents routinely invent step types that sound plausible. The API **silently strips unknown top-level fields** and stores the step, so you get a 201 Created on a workflow that will never execute. Watch for these:
@@ -453,7 +468,7 @@ AI steps can optionally specify a model and provider via the `agent` field:
 | `minimax` | `minimax-m2.5` |
 | `bytedance` | `doubao-seed-1.6-flash`, `seed-2.0-mini`, `doubao-seed-1.8-beta` |
 | `perplexity` | `sonar-pro`, `sonar`, `sonar-reasoning-pro`, `sonar-reasoning` |
-| `xai` | `grok-4-0709`, `grok-3`, `grok-3-mini` |
+| `xai` | `grok-4.3`, `grok-3-mini` |
 
 > **Tip:** Use `list_models` to get the full up-to-date list of supported model IDs. Use the internal model IDs (e.g., `claude-4-6-sonnet`), NOT the raw API model IDs (e.g., `claude-sonnet-4-6`). Using unsupported model IDs will result in a validation error.