@phnx-labs/agents-cli 1.20.74 → 1.20.77

package/dist/lib/workflows.js

@@ -9,7 +9,7 @@ import * as fs from 'fs';
 import * as os from 'os';
 import * as path from 'path';
 import * as yaml from 'yaml';
-import { capableAgents } from './capabilities.js';
+import { capableAgents, supports } from './capabilities.js';
 import { getProjectAgentsDir, getSystemWorkflowsDir, getUserWorkflowsDir, getTrashWorkflowsDir, getEnabledExtraRepos, } from './state.js';
 import { listInstalledVersions, getVersionHomePath } from './versions.js';
 /**
@@ -444,6 +444,67 @@ export function transformWorkflowForOpenClaw(workflowPath, name) {
         ],
     });
 }
+/** Marker comment prefix written into agents-cli-managed Grok `.rhai` files. */
+export const GROK_WORKFLOW_MARKER = 'agents_workflow';
+/** Escape a string for embedding inside a Rhai double-quoted literal. */
+function escapeRhaiString(s) {
+    return s
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\r\n/g, '\\n')
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\n');
+}
+/**
+ * Convert a canonical agents-cli workflow bundle into a Grok native Rhai
+ * workflow script. Grok discovers saved workflows as
+ * `~/.grok/workflows/<name>.rhai` (and project `.grok/workflows/`) and exposes
+ * each as a `/<name>` slash command (enabled by default since v0.2.111).
+ *
+ * The projection is a single-agent orchestrator that feeds the WORKFLOW.md
+ * body as the agent prompt plus the caller's `args.prompt` (or string args).
+ * Multi-phase fan-out is left to hand-authored Rhai — agents-cli's job is to
+ * land the orchestrator instructions in the native path.
+ */
+export function transformWorkflowForGrok(workflowPath, name) {
+    const fm = parseWorkflowFrontmatter(workflowPath);
+    if (!fm)
+        throw new Error(`Invalid WORKFLOW.md in ${workflowPath}`);
+    const body = getWorkflowBody(workflowPath);
+    const description = (fm.description || name).trim();
+    const instructions = (body || description).trim();
+    return [
+        `// ${GROK_WORKFLOW_MARKER}: ${name}`,
+        `// Managed by agents-cli — re-sync from ~/.agents/workflows/${name}/; do not edit by hand.`,
+        `let meta = #{`,
+        `    name: "${escapeRhaiString(name)}",`,
+        `    description: "${escapeRhaiString(description)}",`,
+        `    phases: [ #{ title: "Run", detail: "orchestrator" } ],`,
+        `};`,
+        ``,
+        `let user_prompt = if args == () { () } else if type_of(args) == "string" { args } else { args.prompt };`,
+        `if user_prompt == () { pause("verification", "Pass a prompt as args.prompt or a string arg."); }`,
+        ``,
+        `phase("Run");`,
+        `let instructions = "${escapeRhaiString(instructions)}";`,
+        `let prompt = instructions + "\\n\\n---\\n\\nUser request:\\n" + user_prompt;`,
+        `let r = agent(prompt, #{ label: "orchestrator", capability_mode: "all" });`,
+        `if r != () && r.success { complete(r.output); }`,
+        `complete(#{ summary: "workflow failed", error: if r == () { "no result" } else { "agent failed" } });`,
+        ``,
+    ].join('\n');
+}
+/** Read the agents_workflow marker from a Grok `.rhai` file, if present. */
+export function grokWorkflowMarker(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const match = content.match(new RegExp(`^//\\s*${GROK_WORKFLOW_MARKER}:\\s*(\\S+)`, 'm'));
+        return match?.[1] ?? null;
+    }
+    catch {
+        return null;
+    }
+}
 function expandWorkflowPath(ref) {
     if (ref === '~')
         return process.env.HOME ?? ref;
@@ -622,6 +683,8 @@ function workflowTargetRoot(agent, versionHome) {
         return antigravityWorkflowsDir();
     if (agent === 'openclaw')
         return path.join(versionHome, '.openclaw', 'workflows');
+    if (agent === 'grok')
+        return path.join(versionHome, '.grok', 'workflows');
     return path.join(versionHome, 'workflows');
 }
 /** List workflow names synced into a specific agent version home. */
@@ -676,6 +739,20 @@ export function listWorkflowsForAgent(agent, versionHome) {
             return [];
         }
     }
+    if (agent === 'grok') {
+        const dir = workflowTargetRoot(agent, versionHome);
+        if (!fs.existsSync(dir))
+            return [];
+        try {
+            return fs.readdirSync(dir, { withFileTypes: true })
+                .filter(d => d.isFile() && d.name.endsWith('.rhai') && !d.name.startsWith('.'))
+                .map(d => d.name.slice(0, -'.rhai'.length))
+                .filter(base => grokWorkflowMarker(path.join(dir, `${base}.rhai`)) === base);
+        }
+        catch {
+            return [];
+        }
+    }
     const workflowsDir = workflowTargetRoot(agent, versionHome);
     if (!fs.existsSync(workflowsDir))
         return [];
@@ -823,6 +900,19 @@ export function syncWorkflowToVersion(workflowPath, name, agent, versionHome) {
             fs.writeFileSync(targetFile, transformWorkflowForOpenClaw(workflowPath, name), 'utf-8');
             return { success: true };
         }
+        if (agent === 'grok') {
+            const targetDir = workflowTargetRoot(agent, versionHome);
+            const targetFile = path.join(targetDir, `${name}.rhai`);
+            if (fs.existsSync(targetFile)) {
+                const marker = grokWorkflowMarker(targetFile);
+                if (marker !== name) {
+                    return { success: false, error: `Grok workflow '${name}' already exists and is not managed by agents-cli` };
+                }
+            }
+            fs.mkdirSync(targetDir, { recursive: true });
+            fs.writeFileSync(targetFile, transformWorkflowForGrok(workflowPath, name), 'utf-8');
+            return { success: true };
+        }
         const targetDir = path.join(workflowTargetRoot(agent, versionHome), name);
         fs.mkdirSync(workflowTargetRoot(agent, versionHome), { recursive: true });
         if (fs.existsSync(targetDir)) {
@@ -887,6 +977,22 @@ export function removeWorkflowFromVersion(agent, version, name) {
             return { success: false, error: err.message };
         }
     }
+    if (agent === 'grok') {
+        const targetFile = path.join(workflowTargetRoot(agent, versionHome), `${name}.rhai`);
+        if (!fs.existsSync(targetFile)) {
+            return { success: false, error: `Workflow '${name}' not synced to ${agent}@${version}` };
+        }
+        if (grokWorkflowMarker(targetFile) !== name) {
+            return { success: false, error: `Grok workflow '${name}' is not managed by agents-cli` };
+        }
+        try {
+            fs.rmSync(targetFile, { force: true });
+            return { success: true };
+        }
+        catch (err) {
+            return { success: false, error: err.message };
+        }
+    }
     const targetPath = path.join(workflowTargetRoot(agent, versionHome), name);
     if (!fs.existsSync(targetPath)) {
         return { success: false, error: `Workflow '${name}' not synced to ${agent}@${version}` };
@@ -958,6 +1064,9 @@ export function iterWorkflowsCapableVersions(filter) {
         for (const version of versions) {
             if (filter?.version && filter.version !== version)
                 continue;
+            // Honour version floors (e.g. grok workflows since 0.2.111).
+            if (!supports(agentId, 'workflows', version).ok)
+                continue;
             result.push({ agent: agentId, version });
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phnx-labs/agents-cli",
-  "version": "1.20.74",
+  "version": "1.20.77",
   "description": "One CLI for all your AI coding agents - versions, config, cloud dispatch, sessions, and teams (now with first-class Grok Build CLI support)",
   "type": "module",
   "main": "dist/index.js",