wordspace 0.0.12 → 0.0.14

package/dist/commands/run.d.ts

@@ -1 +1,6 @@
-export declare function run(target: string | undefined, force: boolean, harnessArg?: string): Promise<void>;
+export interface RunOptions {
+    params?: Record<string, string>;
+    skillsDir?: string;
+    model?: 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.
@@ -12,22 +13,58 @@ import * as log from "../lib/log.js";
  * Skill-native harnesses (Claude Code) get the short `/open-prose run <path>` command.
  * All others receive the .prose file content inline with execution instructions.
  */
-function buildPrompt(harness, prosePath, cwd) {
+function buildPrompt(harness, prosePath, cwd, params) {
     if (harness.skillNative) {
+        if (params && Object.keys(params).length > 0) {
+            return `/open-prose run ${prosePath} --params '${JSON.stringify(params)}'`;
+        }
         return `/open-prose run ${prosePath}`;
     }
     const fullPath = join(cwd, prosePath);
     const content = readFileSync(fullPath, "utf-8");
-    return [
+    const lines = [
         `You are executing a wordspace workflow defined in the file "${prosePath}".`,
         `Follow the steps below exactly. Write all output files to the "output/" directory.`,
-        "",
-        "--- BEGIN WORKFLOW ---",
-        content,
-        "--- END WORKFLOW ---",
-    ].join("\n");
+    ];
+    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("", "--- BEGIN WORKFLOW ---", content, "--- END WORKFLOW ---");
+    return lines.join("\n");
+}
+/**
+ * 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) {
+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);
@@ -86,7 +123,7 @@ export async function run(target, force, harnessArg) {
     }
     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
@@ -116,12 +153,12 @@ export async function run(target, force, harnessArg) {
         }
         prosePath = target;
     }
-    const prompt = buildPrompt(harness, prosePath, cwd);
     if (harness.mode === "passthrough") {
-        // The calling agent is already running — just output the prompt
-        console.log(prompt);
+        const passthroughPrompt = buildPassthroughPrompt(prosePath, cwd, options?.params, options?.skillsDir);
+        console.log(passthroughPrompt);
         process.exit(0);
     }
+    const prompt = buildPrompt(harness, prosePath, cwd, options?.params);
     console.log();
     if (harness.skillNative) {
         log.info(prompt);
@@ -130,6 +167,6 @@ export async function run(target, force, harnessArg) {
         log.info(`Running ${prosePath} via ${harness.name}...`);
     }
     console.log();
-    const exitCode = spawnHarness(harness, prompt, cwd);
+    const exitCode = spawnHarness(harness, prompt, cwd, options?.model);
     process.exit(exitCode);
 }

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.12";
+const VERSION = "0.0.14";
 const HELP = `
 Usage: wordspace <command> [options]
 
@@ -17,6 +17,9 @@ Commands:
 Options:
   --force            Re-run all steps / overwrite existing files
   --harness <name>   Use a specific coding agent (e.g. claude, aider, goose)
+  --model <model>    Model to pass to the harness (e.g. openrouter/minimax/minimax-m2.5)
+  --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 +33,31 @@ 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 modelArg;
+    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] === "--model") {
+            modelArg = 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 +75,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, model: modelArg });
     }
     else if (!command) {
         console.log(HELP);

package/dist/lib/harness.d.ts

@@ -3,8 +3,8 @@ export interface Harness {
     name: string;
     /** Binary name on PATH. */
     bin: string;
-    /** Build the CLI args from the prompt string. */
-    args: (prompt: string) => string[];
+    /** Build the CLI args from the prompt string and optional model. */
+    args: (prompt: string, model?: string) => string[];
     /** URL or install command the user can use to install this harness. */
     installUrl: string;
     /** Whether the harness runs interactively, headless, or passthrough (already running). */
@@ -17,4 +17,4 @@ export declare const HARNESSES: Harness[];
 /** Return only the harnesses whose binary is found on PATH. */
 export declare function detectInstalled(): Harness[];
 /** Spawn a harness interactively, handing over the terminal. */
-export declare function spawnHarness(harness: Harness, prompt: string, cwd: string): number;
+export declare function spawnHarness(harness: Harness, prompt: string, cwd: string, model?: string): number;

package/dist/lib/harness.js

@@ -44,9 +44,13 @@ export const HARNESSES = [
     {
         name: "OpenCode",
         bin: "opencode",
-        args: (prompt) => ["--prompt", prompt],
+        args: (prompt, model) => [
+            "run",
+            "--prompt", prompt,
+            ...(model ? ["--model", model] : []),
+        ],
         installUrl: "https://opencode.ai",
-        mode: "interactive",
+        mode: "headless",
         skillNative: false,
     },
     {
@@ -103,8 +107,8 @@ export function detectInstalled() {
     });
 }
 /** Spawn a harness interactively, handing over the terminal. */
-export function spawnHarness(harness, prompt, cwd) {
-    const result = spawnSync(harness.bin, harness.args(prompt), {
+export function spawnHarness(harness, prompt, cwd, model) {
+    const result = spawnSync(harness.bin, harness.args(prompt, model), {
         cwd,
         stdio: "inherit",
     });

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.12",
+  "version": "0.0.14",
   "type": "module",
   "files": [
     "dist"