rhachet 1.19.1 → 1.19.3

package/dist/domain.operations/actor/actorRun.js

@@ -14,10 +14,11 @@ const actorRun = async (input) => {
     for (const [key, value] of Object.entries(input.args)) {
         argsArray.push(`--${key}`, String(value));
     }
-    // execute skill via spawn
+    // execute skill via spawn (capture mode for SDK return value)
     const result = await (0, executeSkill_1.executeSkill)({
         skill: input.skill.executable,
         args: argsArray,
+        stream: false,
     });
     return result;
 };

package/dist/domain.operations/actor/actorRun.js.map

@@ -1 +1 @@
-{"version":3,"file":"actorRun.js","sourceRoot":"","sources":["../../../src/domain.operations/actor/actorRun.ts"],"names":[],"mappings":";;;AACA,6EAA0E;AAE1E;;;;;GAKG;AACI,MAAM,QAAQ,GAAG,KAAK,EAAE,KAG9B,EAAoB,EAAE;IACrB,8CAA8C;IAC9C,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,SAAS,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,0BAA0B;IAC1B,MAAM,MAAM,GAAG,MAAM,IAAA,2BAAY,EAAC;QAChC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU;QAC7B,IAAI,EAAE,SAAS;KAChB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAjBW,QAAA,QAAQ,YAiBnB"}
+{"version":3,"file":"actorRun.js","sourceRoot":"","sources":["../../../src/domain.operations/actor/actorRun.ts"],"names":[],"mappings":";;;AACA,6EAA0E;AAE1E;;;;;GAKG;AACI,MAAM,QAAQ,GAAG,KAAK,EAAE,KAG9B,EAAoB,EAAE;IACrB,8CAA8C;IAC9C,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,SAAS,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,8DAA8D;IAC9D,MAAM,MAAM,GAAG,MAAM,IAAA,2BAAY,EAAC;QAChC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU;QAC7B,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAlBW,QAAA,QAAQ,YAkBnB"}

package/dist/domain.operations/invoke/executeSkill.d.ts

@@ -3,9 +3,11 @@ import type { RoleSkillExecutable } from '../../domain.objects/RoleSkillExecutab
  * .what = executes a skill script with passthrough args
  * .why = runs the discovered skill with full arg passthrough
  *
- * .note = captures stdout and parses JSON output when available
+ * .note = when stream=true (default), streams stdout/stderr progressively
+ * .note = when stream=false, captures stdout and parses JSON output
  */
 export declare const executeSkill: (input: {
     skill: RoleSkillExecutable;
     args: string[];
+    stream?: boolean;
 }) => unknown;

package/dist/domain.operations/invoke/executeSkill.js

@@ -6,9 +6,12 @@ const node_child_process_1 = require("node:child_process");
  * .what = executes a skill script with passthrough args
  * .why = runs the discovered skill with full arg passthrough
  *
- * .note = captures stdout and parses JSON output when available
+ * .note = when stream=true (default), streams stdout/stderr progressively
+ * .note = when stream=false, captures stdout and parses JSON output
  */
 const executeSkill = (input) => {
+    // default to streaming (backwards compatible with CLI behavior)
+    const stream = input.stream ?? true;
     // build command with args
     const command = [input.skill.path, ...input.args]
         .map((arg) => {
@@ -18,7 +21,16 @@ const executeSkill = (input) => {
         return arg;
     })
         .join(' ');
-    // execute and capture stdout
+    // streaming mode: inherit stdio for progressive output
+    if (stream) {
+        (0, node_child_process_1.execSync)(command, {
+            cwd: process.cwd(),
+            shell: '/bin/bash',
+            stdio: 'inherit',
+        });
+        return undefined;
+    }
+    // capture mode: capture stdout for JSON parsing
     const stdout = (0, node_child_process_1.execSync)(command, {
         cwd: process.cwd(),
         shell: '/bin/bash',

package/dist/domain.operations/invoke/executeSkill.js.map

@@ -1 +1 @@
-{"version":3,"file":"executeSkill.js","sourceRoot":"","sources":["../../../src/domain.operations/invoke/executeSkill.ts"],"names":[],"mappings":";;;AAEA,2DAA8C;AAE9C;;;;;GAKG;AACI,MAAM,YAAY,GAAG,CAAC,KAG5B,EAAW,EAAE;IACZ,0BAA0B;IAC1B,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC;SAC9C,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,yBAAyB;QACzB,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,GAAG,GAAG,CAAC;QACzC,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,6BAA6B;IAC7B,MAAM,MAAM,GAAG,IAAA,6BAAQ,EAAC,OAAO,EAAE;QAC/B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,KAAK,EAAE,WAAW;QAClB,QAAQ,EAAE,OAAO;KAClB,CAAC,CAAC;IAEH,+BAA+B;IAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAE/B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;QACtC,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC,CAAC;AA9BW,QAAA,YAAY,gBA8BvB"}
+{"version":3,"file":"executeSkill.js","sourceRoot":"","sources":["../../../src/domain.operations/invoke/executeSkill.ts"],"names":[],"mappings":";;;AAEA,2DAA8C;AAE9C;;;;;;GAMG;AACI,MAAM,YAAY,GAAG,CAAC,KAI5B,EAAW,EAAE;IACZ,gEAAgE;IAChE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC;IAEpC,0BAA0B;IAC1B,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC;SAC9C,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,yBAAyB;QACzB,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,GAAG,GAAG,CAAC;QACzC,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,uDAAuD;IACvD,IAAI,MAAM,EAAE,CAAC;QACX,IAAA,6BAAQ,EAAC,OAAO,EAAE;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,KAAK,EAAE,WAAW;YAClB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,gDAAgD;IAChD,MAAM,MAAM,GAAG,IAAA,6BAAQ,EAAC,OAAO,EAAE;QAC/B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,KAAK,EAAE,WAAW;QAClB,QAAQ,EAAE,OAAO;KAClB,CAAC,CAAC;IAEH,+BAA+B;IAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAE/B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;QACtC,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC,CAAC;AA5CW,QAAA,YAAY,gBA4CvB"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "rhachet",
   "author": "ehmpathy",
   "description": "A framework for reliable, thorough thought. Weave threads of thought via stitches.",
-  "version": "1.19.1",
+  "version": "1.19.3",
   "repository": "ehmpathy/rhachet",
   "homepage": "https://github.com/ehmpathy/rhachet",
   "keywords": [

package/readme.md

@@ -15,7 +15,7 @@ rhachet makes it simple to leverage thought routes - safely, easily, and effecti
 - 🔩 **rigid** routes for augmented orchestration
 - 💧 **fluid** routes for probabalistic exploration
 
-with rhachet, you can:
+with rhachet, you can
 - declare thought routes, reusably and maintainably
 - apply thought routes, observably and reliably
 - compose and accumulate reusable thought skill
@@ -86,7 +86,7 @@ npm install rhachet
 
 ## cli
 
-rhachet provides cli commands for each thought route:
+rhachet provides cli commands for each thought route
 
 | command           | route   | what it does                               |
 | ----------------- | ------- | ------------------------------------------ |
@@ -111,14 +111,16 @@ export const getRoleRegistries = () => [
 
 ### 🪨 solid: run
 
+deterministic operations, no brain.
+
 ```sh
 npx rhachet run --skill gh.workflow.logs --workflow test
 ```
 
-deterministic operations, no brain.
-
 ### 🔩 rigid: act
 
+augmented orchestration, harness controls flow, brain augments.
+
 ```sh
 npx rhachet act \
   --role mechanic --skill review \
@@ -130,18 +132,16 @@ npx rhachet act \
   --brain openai/codex
 ```
 
-augmented orchestration, harness controls flow, brain augments.
-
 ### 💧 fluid: ask
 
+probabilistic exploration, brain decides the path.
+
 ```sh
 npx rhachet ask \
   --role skeptic \
   --ask "are birds real?"
 ```
 
-probabilistic exploration, brain decides the path.
-
 ## sdk
 
 rhachet provides a type-safe sdk for programmatic actor usage.
@@ -177,16 +177,18 @@ the `brains` allowlist:
 
 ### 🪨 solid: run
 
+deterministic operations, no brain.
+
 ```ts
 await mechanic.run({
   skill: { 'gh.workflow.logs': { workflow: 'test' } },
 });
 ```
 
-deterministic operations, no brain.
-
 ### 🔩 rigid: act
 
+augmented orchestration, harness controls flow, brain augments.
+
 ```ts
 // uses default brain (first in allowlist)
 await mechanic.act({
@@ -200,18 +202,16 @@ await mechanic.act({
 });
 ```
 
-augmented orchestration, harness controls flow, brain augments.
-
 ### 💧 fluid: ask
 
+probabilistic exploration, brain decides the path.
+
 ```ts
 await skeptic.ask({
   prompt: 'are birds real?',
 });
 ```
 
-probabilistic exploration, brain decides the path.
-
 # vision
 
 build or use digital actors, who work even from your laptop, and work for anyone you choose.