wordspace 0.0.11 → 0.0.13

package/dist/commands/run.d.ts

@@ -1 +1,5 @@
-export declare function run(target: string | undefined, force: boolean, harnessArg?: string): Promise<void>;
+export interface RunOptions {
+    params?: Record<string, string>;
+    skillsDir?: string;
+}
+export declare function run(target: string | undefined, force: boolean, harnessArg?: string, options?: RunOptions): Promise<void>;

package/dist/commands/run.js

@@ -5,6 +5,7 @@ import { httpGet, getAuthHeaders } from "../lib/workflows.js";
 import { HARNESSES, detectInstalled, spawnHarness, } from "../lib/harness.js";
 import { pickOne } from "../lib/prompt.js";
 import { ensureInit } from "../steps/auto-init.js";
+import { discoverSkills } from "../lib/skills.js";
 import * as log from "../lib/log.js";
 /**
  * Build the prompt string for a given harness.
@@ -27,7 +28,35 @@ function buildPrompt(harness, prosePath, cwd) {
         "--- END WORKFLOW ---",
     ].join("\n");
 }
-export async function run(target, force, harnessArg) {
+/**
+ * Build a rich passthrough prompt that tells the calling agent where skills
+ * are installed, how to use open-prose, and provides workflow params.
+ */
+function buildPassthroughPrompt(prosePath, cwd, params, skillsDir) {
+    const fullPath = join(cwd, prosePath);
+    const content = readFileSync(fullPath, "utf-8");
+    const discovery = discoverSkills(cwd, skillsDir);
+    const lines = [];
+    if (discovery) {
+        const skillList = discovery.skills
+            .map((s) => `  - ${s.name}`)
+            .join("\n");
+        lines.push(`You have access to the following skills installed at ${discovery.dir}:`, skillList, "", "To execute this workflow:", "", `1. Read the open-prose skill: ${discovery.dir}/open-prose/SKILL.md`, "2. Follow its instructions to load the VM (prose.md) and become the OpenProse interpreter", `3. Run the workflow file: ${prosePath}`);
+    }
+    else {
+        lines.push(`You are executing a wordspace workflow defined in the file "${prosePath}".`, `Follow the steps below exactly. Write all output files to the "output/" directory.`);
+    }
+    if (params && Object.keys(params).length > 0) {
+        lines.push("", "The following input parameters have been provided:");
+        for (const [key, value] of Object.entries(params)) {
+            lines.push(`  ${key} = "${value}"`);
+        }
+        lines.push("Use these values for the corresponding `input` declarations in the workflow.");
+    }
+    lines.push("", `--- WORKFLOW: ${prosePath} ---`, content, "--- END WORKFLOW ---");
+    return lines.join("\n");
+}
+export async function run(target, force, harnessArg, options) {
     if (!target) {
         log.error("Usage: wordspace run <github:owner/repo/path.prose | local-path>");
         process.exit(1);
@@ -68,16 +97,25 @@ export async function run(target, force, harnessArg) {
         }
         else {
             log.step("Pick a coding agent");
-            harness = await pickOne(installed, (h) => h.mode === "headless" ? `${h.name} (headless)` : h.name, "Select harness");
+            harness = await pickOne(installed, (h) => {
+                if (h.mode === "headless")
+                    return `${h.name} (headless)`;
+                if (h.mode === "passthrough")
+                    return `${h.name} (passthrough)`;
+                return h.name;
+            }, "Select harness");
         }
     }
     log.success(`Using ${harness.name}`);
     if (harness.mode === "headless") {
         log.warn("Headless mode — the agent will execute and exit without interaction.");
     }
+    else if (harness.mode === "passthrough") {
+        log.info("Passthrough mode — outputting workflow for the calling agent.");
+    }
     const cwd = process.cwd();
     // Auto-init if needed (harness-aware)
-    ensureInit(cwd, harness);
+    ensureInit(cwd, harness, options?.skillsDir);
     let prosePath;
     if (target.startsWith("github:")) {
         // Remote: download from GitHub
@@ -107,6 +145,11 @@ export async function run(target, force, harnessArg) {
         }
         prosePath = target;
     }
+    if (harness.mode === "passthrough") {
+        const passthroughPrompt = buildPassthroughPrompt(prosePath, cwd, options?.params, options?.skillsDir);
+        console.log(passthroughPrompt);
+        process.exit(0);
+    }
     const prompt = buildPrompt(harness, prosePath, cwd);
     console.log();
     if (harness.skillNative) {

package/dist/index.js

@@ -4,7 +4,7 @@ import { search } from "./commands/search.js";
 import { add } from "./commands/add.js";
 import { run } from "./commands/run.js";
 import * as log from "./lib/log.js";
-const VERSION = "0.0.11";
+const VERSION = "0.0.13";
 const HELP = `
 Usage: wordspace <command> [options]
 
@@ -17,6 +17,8 @@ Commands:
 Options:
   --force            Re-run all steps / overwrite existing files
   --harness <name>   Use a specific coding agent (e.g. claude, aider, goose)
+  --params <json>    Workflow input parameters as JSON (e.g. '{"topic":"x402"}')
+  --skills-dir <dir> Custom skills directory (default: auto-discover)
   --help             Show this help message
   --version          Show version number
 `.trim();
@@ -30,13 +32,27 @@ async function main() {
         console.log(VERSION);
         process.exit(0);
     }
-    const harnessIdx = args.indexOf("--harness");
-    const harnessArg = harnessIdx !== -1 ? args[harnessIdx + 1] : undefined;
+    let harnessArg;
+    let params;
+    let skillsDir;
     // Filter out flags and their values from positional args
     const positional = [];
     for (let i = 0; i < args.length; i++) {
         if (args[i] === "--harness") {
-            i++; // skip the value
+            harnessArg = args[++i];
+        }
+        else if (args[i] === "--params") {
+            const raw = args[++i];
+            try {
+                params = JSON.parse(raw);
+            }
+            catch {
+                log.error("Invalid --params JSON");
+                process.exit(1);
+            }
+        }
+        else if (args[i] === "--skills-dir") {
+            skillsDir = args[++i];
         }
         else if (!args[i].startsWith("-")) {
             positional.push(args[i]);
@@ -54,7 +70,7 @@ async function main() {
         await add(positional.slice(1), force);
     }
     else if (command === "run") {
-        await run(positional[1], force, harnessArg);
+        await run(positional[1], force, harnessArg, { params, skillsDir });
     }
     else if (!command) {
         console.log(HELP);

package/dist/lib/harness.d.ts

@@ -7,8 +7,8 @@ export interface Harness {
     args: (prompt: string) => string[];
     /** URL or install command the user can use to install this harness. */
     installUrl: string;
-    /** Whether the harness runs interactively or headless. */
-    mode: "interactive" | "headless";
+    /** Whether the harness runs interactively, headless, or passthrough (already running). */
+    mode: "interactive" | "headless" | "passthrough";
     /** Whether the harness natively understands /open-prose skill commands. */
     skillNative: boolean;
 }

package/dist/lib/harness.js

@@ -81,6 +81,14 @@ export const HARNESSES = [
         mode: "interactive",
         skillNative: false,
     },
+    {
+        name: "OpenClaw",
+        bin: "openclaw",
+        args: () => [],
+        installUrl: "npm i -g openclaw@latest",
+        mode: "passthrough",
+        skillNative: false,
+    },
 ];
 /** Return only the harnesses whose binary is found on PATH. */
 export function detectInstalled() {

package/dist/lib/skills.d.ts

@@ -0,0 +1,20 @@
+export interface SkillInfo {
+    name: string;
+    path: string;
+}
+export interface SkillDiscoveryResult {
+    dir: string;
+    skills: SkillInfo[];
+}
+/**
+ * Discover installed skills by checking directories in priority order:
+ * 1. customDir (if --skills-dir provided)
+ * 2. <cwd>/.agents/skills/
+ * 3. ~/.agents/skills/ (home dir global)
+ *
+ * Returns the first directory that contains at least the open-prose skill.
+ * Lists all skills found in that directory (each subdirectory with a SKILL.md).
+ */
+export declare function discoverSkills(cwd: string, customDir?: string): SkillDiscoveryResult | null;
+/** Check whether the required skills are installed in a given directory. */
+export declare function hasRequiredSkills(dir: string): boolean;

package/dist/lib/skills.js

@@ -0,0 +1,44 @@
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+/**
+ * Discover installed skills by checking directories in priority order:
+ * 1. customDir (if --skills-dir provided)
+ * 2. <cwd>/.agents/skills/
+ * 3. ~/.agents/skills/ (home dir global)
+ *
+ * Returns the first directory that contains at least the open-prose skill.
+ * Lists all skills found in that directory (each subdirectory with a SKILL.md).
+ */
+export function discoverSkills(cwd, customDir) {
+    const candidates = [];
+    if (customDir)
+        candidates.push(customDir);
+    candidates.push(join(cwd, ".agents", "skills"));
+    candidates.push(join(homedir(), ".agents", "skills"));
+    for (const dir of candidates) {
+        if (!existsSync(dir))
+            continue;
+        const hasOpenProse = existsSync(join(dir, "open-prose"));
+        if (!hasOpenProse)
+            continue;
+        const skills = [];
+        for (const entry of readdirSync(dir)) {
+            const entryPath = join(dir, entry);
+            if (!statSync(entryPath).isDirectory())
+                continue;
+            if (existsSync(join(entryPath, "SKILL.md"))) {
+                skills.push({ name: entry, path: entryPath });
+            }
+        }
+        if (skills.length > 0) {
+            return { dir, skills };
+        }
+    }
+    return null;
+}
+/** Check whether the required skills are installed in a given directory. */
+export function hasRequiredSkills(dir) {
+    const required = ["open-prose", "agentwallet", "registry", "wordspace"];
+    return required.every((s) => existsSync(join(dir, s)));
+}

package/dist/steps/auto-init.d.ts

@@ -1,3 +1,3 @@
 import type { Harness } from "../lib/harness.js";
 /** Silently initialize the project if not already done. */
-export declare function ensureInit(cwd: string, harness: Harness): void;
+export declare function ensureInit(cwd: string, harness: Harness, customSkillsDir?: string): void;

package/dist/steps/auto-init.js

@@ -3,6 +3,7 @@ import { execSync } from "node:child_process";
 import { join } from "node:path";
 import { setupClaude } from "./setup-claude.js";
 import { createDirs } from "./create-dirs.js";
+import { discoverSkills, hasRequiredSkills } from "../lib/skills.js";
 import * as log from "../lib/log.js";
 const SKILL_PACKAGES = [
     "frames-engineering/skills",
@@ -22,17 +23,14 @@ function installSkills(cwd) {
     }
 }
 /** Silently initialize the project if not already done. */
-export function ensureInit(cwd, harness) {
+export function ensureInit(cwd, harness, customSkillsDir) {
     const isClaude = harness.bin === "claude";
     const hasSettings = isClaude
         ? existsSync(join(cwd, ".claude", "settings.local.json"))
         : true; // non-Claude harnesses don't need Claude settings
     const hasOutput = existsSync(join(cwd, "output"));
-    const skillsDir = join(cwd, ".agents", "skills");
-    const hasSkills = existsSync(join(skillsDir, "open-prose")) &&
-        existsSync(join(skillsDir, "agentwallet")) &&
-        existsSync(join(skillsDir, "registry")) &&
-        existsSync(join(skillsDir, "wordspace"));
+    const discovery = discoverSkills(cwd, customSkillsDir);
+    const hasSkills = discovery !== null && hasRequiredSkills(discovery.dir);
     if (hasSettings && hasOutput && hasSkills)
         return;
     log.info("Auto-initializing project...");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wordspace",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "type": "module",
   "files": [
     "dist"