rhachet 1.17.0 → 1.19.0

package/dist/contract/cli/invoke.js

@@ -5,9 +5,11 @@ const commander_1 = require("commander");
 const helpful_errors_1 = require("helpful-errors");
 const rhachet_artifact_git_1 = require("rhachet-artifact-git");
 const assureUniqueRoles_1 = require("../../domain.operations/invoke/assureUniqueRoles");
+const getBrainReplsByOpts_1 = require("../../domain.operations/invoke/getBrainReplsByOpts");
 const getInvokeHooksByOpts_1 = require("../../domain.operations/invoke/getInvokeHooksByOpts");
 const getRegistriesByOpts_1 = require("../../domain.operations/invoke/getRegistriesByOpts");
 const node_path_1 = require("node:path");
+const invokeAct_1 = require("./invokeAct");
 const invokeAsk_1 = require("./invokeAsk");
 const invokeChoose_1 = require("./invokeChoose");
 const invokeInit_1 = require("./invokeInit");
@@ -46,6 +48,9 @@ const invoke = async (input) => {
     const registries = await (0, getRegistriesByOpts_1.getRegistriesByOpts)({
         opts: { config: configPath },
     });
+    const brains = await (0, getBrainReplsByOpts_1.getBrainReplsByOpts)({
+        opts: { config: configPath },
+    });
     const hooks = await (0, getInvokeHooksByOpts_1.getInvokeHooksByOpts)({
         opts: { config: configPath }, // todo: maybe, getConfigByOpts ? returns both?
     });
@@ -65,9 +70,16 @@ const invoke = async (input) => {
     (0, invokeReadme_1.invokeReadme)({ program, registries });
     (0, invokeList_1.invokeList)({ program, registries });
     (0, invokeRoles_1.invokeRoles)({ program, registries });
-    (0, invokeRun_1.invokeRun)({ program });
+    (0, invokeRun_1.invokeRun)({ program, registries, brains });
     (0, invokeChoose_1.invokeChoose)({ program });
-    (0, invokeAsk_1.invokeAsk)({ program, config: { path: configPath }, registries, hooks });
+    (0, invokeAsk_1.invokeAsk)({
+        program,
+        config: { path: configPath },
+        registries,
+        brains,
+        hooks,
+    });
+    (0, invokeAct_1.invokeAct)({ program, registries, brains, hooks });
     // invoke it
     await program.parseAsync(input.args, { from: 'user' }).catch((error) => {
         if (error instanceof helpful_errors_1.BadRequestError) {

package/dist/contract/cli/invoke.js.map

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

package/dist/contract/cli/invokeAct.d.ts

@@ -0,0 +1,14 @@
+import type { Command } from 'commander';
+import type { BrainRepl } from '../../domain.objects/BrainRepl';
+import type { InvokeHooks } from '../../domain.objects/InvokeHooks';
+import type { RoleRegistry } from '../../domain.objects/RoleRegistry';
+/**
+ * .what = adds the "act" command to the CLI
+ * .why = invokes a rigid skill with brain from any role in the given registries
+ */
+export declare const invokeAct: ({ program, registries, brains, hooks, }: {
+    program: Command;
+    registries: RoleRegistry[];
+    brains: BrainRepl[];
+    hooks: null | InvokeHooks;
+}) => void;

package/dist/contract/cli/invokeAct.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invokeAct = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const genActor_1 = require("../../domain.operations/actor/genActor");
+const assureFindRole_1 = require("../../domain.operations/invoke/assureFindRole");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * .what = adds the "act" command to the CLI
+ * .why = invokes a rigid skill with brain from any role in the given registries
+ */
+const invokeAct = ({ program, registries, brains, hooks, }) => {
+    const actCommand = program
+        .command('act')
+        .description('invoke a rigid skill with brain')
+        .requiredOption('-r, --role <slug>', 'role to invoke')
+        .requiredOption('-s, --skill <slug>', 'skill to invoke')
+        .option('-b, --brain <ref>', 'brain to use (format: repo/slug)')
+        .option('-i, --input <json>', 'input JSON for the skill')
+        .option('-o, --output <path>', 'output file path')
+        .option('--attempts <int>', 'number of independent outputs (requires -o/--output)')
+        .option('--concurrency <int>', 'parallel subthreads limit (default 3)')
+        .allowUnknownOption(true)
+        .allowExcessArguments(true);
+    // 🧠 perform the skill
+    actCommand.action(async (opts) => {
+        // validate brains are available
+        if (brains.length === 0)
+            throw new helpful_errors_1.BadRequestError('no brains available. add getBrainRepls() to your rhachet.use.ts');
+        // find the role
+        const role = (0, assureFindRole_1.assureFindRole)({ registries, slug: opts.role });
+        if (!role)
+            throw new helpful_errors_1.BadRequestError(`role "${opts.role}" not found`, {
+                availableRoles: registries.flatMap((r) => r.roles.map((rr) => rr)),
+            });
+        // resolve brain reference if provided
+        let brainRef;
+        if (opts.brain) {
+            // split on first '/' only; slug may contain additional slashes
+            const firstSlashIndex = opts.brain.indexOf('/');
+            if (firstSlashIndex === -1)
+                throw new helpful_errors_1.BadRequestError(`invalid brain format "${opts.brain}". expected: repo/slug`);
+            const repo = opts.brain.slice(0, firstSlashIndex);
+            const slug = opts.brain.slice(firstSlashIndex + 1);
+            if (!repo || !slug)
+                throw new helpful_errors_1.BadRequestError(`invalid brain format "${opts.brain}". expected: repo/slug`);
+            brainRef = { repo, slug };
+        }
+        // create actor with all available brains
+        const actor = (0, genActor_1.genActor)({ role, brains });
+        // parse skill input
+        const skillArgs = opts.input ? JSON.parse(opts.input) : {};
+        // apply hooks if present
+        const inputWithHooks = hooks?.onInvokeActInput
+            ? hooks.onInvokeActInput({ skill: opts.skill, input: skillArgs })
+            : skillArgs;
+        // determine number of attempts
+        const attempts = opts.attempts ? parseInt(opts.attempts, 10) : 1;
+        // validate attempts requires output
+        if (attempts > 1 && !opts.output)
+            throw new helpful_errors_1.BadRequestError('--attempts requires --output path');
+        // execute skill for each attempt
+        for (let attempt = 1; attempt <= attempts; attempt++) {
+            // log which skill will run
+            console.log(``);
+            console.log(`🔩 skill "${opts.skill}" from role="${opts.role}" attempt=${attempt}/${attempts}`);
+            console.log(``);
+            // invoke actor.act with skill
+            const result = await actor.act({
+                brain: brainRef,
+                skill: { [opts.skill]: inputWithHooks },
+            });
+            // handle output
+            if (opts.output) {
+                // for multiple attempts, suffix with attempt number
+                const outputPath = attempts > 1
+                    ? opts.output.replace(/(\.\w+)$/, `.i${attempt}$1`)
+                    : opts.output;
+                const resolvedPath = (0, node_path_1.resolve)(process.cwd(), outputPath);
+                (0, node_fs_1.writeFileSync)(resolvedPath, JSON.stringify(result, null, 2));
+                console.log(`📝 output written to ${outputPath}`);
+            }
+            else {
+                // output to stdout
+                console.log(JSON.stringify(result, null, 2));
+            }
+        }
+    });
+};
+exports.invokeAct = invokeAct;
+//# sourceMappingURL=invokeAct.js.map

package/dist/contract/cli/invokeAct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invokeAct.js","sourceRoot":"","sources":["../../../src/contract/cli/invokeAct.ts"],"names":[],"mappings":";;;AACA,mDAAiD;AAKjD,oEAAiE;AACjE,iFAA8E;AAE9E,qCAAwC;AACxC,yCAAoC;AAEpC;;;GAGG;AACI,MAAM,SAAS,GAAG,CAAC,EACxB,OAAO,EACP,UAAU,EACV,MAAM,EACN,KAAK,GAMN,EAAQ,EAAE;IACT,MAAM,UAAU,GAAG,OAAO;SACvB,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,iCAAiC,CAAC;SAC9C,cAAc,CAAC,mBAAmB,EAAE,gBAAgB,CAAC;SACrD,cAAc,CAAC,oBAAoB,EAAE,iBAAiB,CAAC;SACvD,MAAM,CAAC,mBAAmB,EAAE,kCAAkC,CAAC;SAC/D,MAAM,CAAC,oBAAoB,EAAE,0BAA0B,CAAC;SACxD,MAAM,CAAC,qBAAqB,EAAE,kBAAkB,CAAC;SACjD,MAAM,CACL,kBAAkB,EAClB,sDAAsD,CACvD;SACA,MAAM,CAAC,qBAAqB,EAAE,uCAAuC,CAAC;SACtE,kBAAkB,CAAC,IAAI,CAAC;SACxB,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAE9B,uBAAuB;IACvB,UAAU,CAAC,MAAM,CACf,KAAK,EAAE,IAQN,EAAE,EAAE;QACH,gCAAgC;QAChC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YACrB,MAAM,IAAI,gCAAe,CACvB,iEAAiE,CAClE,CAAC;QAEJ,gBAAgB;QAChB,MAAM,IAAI,GAAG,IAAA,+BAAc,EAAC,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI;YACP,MAAM,IAAI,gCAAe,CAAC,SAAS,IAAI,CAAC,IAAI,aAAa,EAAE;gBACzD,cAAc,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;aACnE,CAAC,CAAC;QAEL,sCAAsC;QACtC,IAAI,QAAoD,CAAC;QACzD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,+DAA+D;YAC/D,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAChD,IAAI,eAAe,KAAK,CAAC,CAAC;gBACxB,MAAM,IAAI,gCAAe,CACvB,yBAAyB,IAAI,CAAC,KAAK,wBAAwB,CAC5D,CAAC;YACJ,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC;YACnD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI;gBAChB,MAAM,IAAI,gCAAe,CACvB,yBAAyB,IAAI,CAAC,KAAK,wBAAwB,CAC5D,CAAC;YACJ,QAAQ,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC5B,CAAC;QAED,yCAAyC;QACzC,MAAM,KAAK,GAAG,IAAA,mBAAQ,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAEzC,oBAAoB;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAE3D,yBAAyB;QACzB,MAAM,cAAc,GAAG,KAAK,EAAE,gBAAgB;YAC5C,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YACjE,CAAC,CAAC,SAAS,CAAC;QAEd,+BAA+B;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEjE,oCAAoC;QACpC,IAAI,QAAQ,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM;YAC9B,MAAM,IAAI,gCAAe,CAAC,mCAAmC,CAAC,CAAC;QAEjE,iCAAiC;QACjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC;YACrD,2BAA2B;YAC3B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CACT,aAAa,IAAI,CAAC,KAAK,gBAAgB,IAAI,CAAC,IAAI,aAAa,OAAO,IAAI,QAAQ,EAAE,CACnF,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAEhB,8BAA8B;YAC9B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC;gBAC7B,KAAK,EAAE,QAAQ;gBACf,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,cAAc,EAAE;aACxC,CAAC,CAAC;YAEH,gBAAgB;YAChB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,oDAAoD;gBACpD,MAAM,UAAU,GACd,QAAQ,GAAG,CAAC;oBACV,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,OAAO,IAAI,CAAC;oBACnD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;gBAClB,MAAM,YAAY,GAAG,IAAA,mBAAO,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;gBACxD,IAAA,uBAAa,EAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC7D,OAAO,CAAC,GAAG,CAAC,wBAAwB,UAAU,EAAE,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,mBAAmB;gBACnB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC,CAAC;AAvHW,QAAA,SAAS,aAuHpB"}

package/dist/contract/cli/invokeAsk.d.ts

@@ -1,15 +1,18 @@
 import type { Command } from 'commander';
+import type { BrainRepl } from '../../domain.objects/BrainRepl';
 import type { InvokeHooks } from '../../domain.objects/InvokeHooks';
 import type { RoleRegistry } from '../../domain.objects/RoleRegistry';
 /**
  * .what = adds the "ask" command to the CLI
  * .why = lets users invoke a skill from any role in the given registries
+ *        or start a fluid conversation with an actor (when no --skill)
  */
-export declare const invokeAsk: ({ program, registries, ...input }: {
+export declare const invokeAsk: ({ program, registries, brains, ...input }: {
     program: Command;
     config: {
         path: string;
     };
     registries: RoleRegistry[];
+    brains: BrainRepl[];
     hooks: null | InvokeHooks;
 }) => void;

package/dist/contract/cli/invokeAsk.js

@@ -2,27 +2,82 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.invokeAsk = void 0;
 const helpful_errors_1 = require("helpful-errors");
+const genActor_1 = require("../../domain.operations/actor/genActor");
 const assureFindRole_1 = require("../../domain.operations/invoke/assureFindRole");
 const onInvokeAskInput_1 = require("../../domain.operations/invoke/hooks/onInvokeAskInput");
 const performInCurrentThread_1 = require("../../domain.operations/invoke/performInCurrentThread");
 const performInIsolatedThreads_1 = require("../../domain.operations/invoke/performInIsolatedThreads");
+/**
+ * .what = performs ask via stitch-mode (--skill invocation)
+ * .why = executes a registered skill with deterministic stitch-threads
+ */
+const performAskViaStitchMode = async (input) => {
+    // instantiate the composed argv
+    const argvWithAsk = {
+        ...input.opts,
+        ask: input.opts.ask ??
+            helpful_errors_1.UnexpectedCodePathError.throw('ask was not declared', {
+                opts: input.opts,
+            }),
+        config: input.config.path, // required for isolated child threads when used with attempts
+    };
+    // apply the onInvokeAskHooks
+    const argvWithHooks = input.hooks
+        ? (0, onInvokeAskInput_1.onInvokeAskInput)({ opts: argvWithAsk, hooks: input.hooks })
+        : argvWithAsk;
+    // if attempts were requested, perform the skill in isolated threads per attempt
+    if (input.opts.attempts)
+        return await (0, performInIsolatedThreads_1.performInIsolatedThreads)({ opts: argvWithHooks });
+    // otherwise, perform in the main thread by default
+    return await (0, performInCurrentThread_1.performInCurrentThread)({
+        opts: argvWithHooks,
+        registries: input.registries,
+    });
+};
+/**
+ * .what = performs ask via actor-mode (fluid brain conversation)
+ * .why = enables open-ended conversation with a role via brain.repl
+ */
+const performAskViaActorMode = async (input) => {
+    // validate brains are available
+    if (input.brains.length === 0)
+        throw new helpful_errors_1.BadRequestError('no brains available. add getBrainRepls() to your rhachet.use.ts');
+    // create actor with all available brains
+    const actor = (0, genActor_1.genActor)({ role: input.role, brains: input.brains });
+    // validate prompt is provided
+    if (!input.opts.ask)
+        throw new helpful_errors_1.BadRequestError('--ask is required (e.g., --ask "review my code")');
+    // log which role will be asked
+    console.log(``);
+    console.log(`🌊 ask role="${input.opts.role}"`);
+    console.log(``);
+    // invoke actor.ask
+    const result = await actor.ask({ prompt: input.opts.ask });
+    // output response
+    console.log(result.response);
+};
 /**
  * .what = adds the "ask" command to the CLI
  * .why = lets users invoke a skill from any role in the given registries
+ *        or start a fluid conversation with an actor (when no --skill)
  */
-const invokeAsk = ({ program, registries, ...input }) => {
+const invokeAsk = ({ program, registries, brains, ...input }) => {
     const askCommand = program
         .command('ask')
+        .description('invoke a skill or start a fluid conversation with an actor')
         .requiredOption('-r, --role <slug>', 'role to invoke')
-        .requiredOption('-s, --skill <slug>', 'skill to invoke')
-        .option('-a, --ask <ask>', 'your ask')
+        .option('-s, --skill <slug>', 'skill to invoke (stitch-mode)')
+        .option('-a, --ask <ask>', 'your ask or prompt')
         .option('--attempts <int>', 'number of independent outputs (requires -o/--output)')
         .option('--concurrency <int>', 'parallel subthreads limit (default 3)')
         .allowUnknownOption(true)
         .allowExcessArguments(true);
-    // 💉 dynamically inject CLI flags from skill inputs
+    // 💉 dynamically inject CLI flags from skill inputs (only in stitch-mode)
     askCommand.hook('preAction', (thisCommand) => {
         const opts = thisCommand.opts();
+        // skip dynamic injection if no skill specified (actor-mode)
+        if (!opts.skill)
+            return;
         const role = (0, assureFindRole_1.assureFindRole)({ registries, slug: opts.role });
         const skill = role?.skills.refs.find((s) => s.slug === opts.skill);
         if (!skill)
@@ -42,24 +97,32 @@ const invokeAsk = ({ program, registries, ...input }) => {
         // re-parse with updated option definitions
         thisCommand.parseOptions(thisCommand.parent?.args ?? []);
     });
-    // 🧠 perform the skill
+    // 🧠 perform the skill or actor conversation
     askCommand.action(async (opts) => {
-        // instantiate the composed argv
-        const argvWithAsk = {
-            ...opts,
-            ask: opts.ask ??
-                helpful_errors_1.UnexpectedCodePathError.throw('ask was not declared', { opts }),
-            config: input.config.path, // required for isolated child threads when used with attempts
-        };
-        // apply the onInvokeAskHooks
-        const argvWithHooks = input.hooks
-            ? (0, onInvokeAskInput_1.onInvokeAskInput)({ opts: argvWithAsk, hooks: input.hooks })
-            : argvWithAsk;
-        // if attempts were requested, perform the skill in isolated threads per attempt
-        if (opts.attempts)
-            return await (0, performInIsolatedThreads_1.performInIsolatedThreads)({ opts: argvWithHooks });
-        // otherwise, perform in the main thread by default
-        return await (0, performInCurrentThread_1.performInCurrentThread)({ opts: argvWithHooks, registries });
+        // determine which mode to use
+        const isStitchMode = opts.skill !== undefined;
+        const isActorMode = !isStitchMode;
+        // 🧵 stitch-mode: invoke skill via thread stitching
+        if (isStitchMode) {
+            const skill = opts.skill; // asserted as string (validated by isStitchMode)
+            return await performAskViaStitchMode({
+                opts: { ...opts, skill },
+                config: input.config,
+                registries,
+                hooks: input.hooks,
+            });
+        }
+        // 🌊 actor-mode: invoke fluid conversation via brain.repl
+        if (isActorMode) {
+            const role = (0, assureFindRole_1.assureFindRole)({ registries, slug: opts.role });
+            if (!role)
+                throw new helpful_errors_1.BadRequestError(`role "${opts.role}" not found`, {
+                    availableRoles: registries.flatMap((r) => r.roles),
+                });
+            return await performAskViaActorMode({ opts, role, brains });
+        }
+        // neither mode matched - unexpected
+        throw new helpful_errors_1.UnexpectedCodePathError('invokeAsk: neither stitch-mode nor actor-mode matched', { opts });
     });
 };
 exports.invokeAsk = invokeAsk;

package/dist/contract/cli/invokeAsk.js.map

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

package/dist/contract/cli/invokeRun.d.ts

@@ -1,8 +1,12 @@
 import type { Command } from 'commander';
+import type { BrainRepl } from '../../domain.objects/BrainRepl';
+import type { RoleRegistry } from '../../domain.objects/RoleRegistry';
 /**
  * .what = adds the "run" command to the CLI
- * .why = discovers and executes skills from linked role directories
+ * .why = discovers and executes solid skills (deterministic, no brain)
  */
-export declare const invokeRun: ({ program }: {
+export declare const invokeRun: ({ program, registries, brains, }: {
     program: Command;
+    registries: RoleRegistry[];
+    brains: BrainRepl[];
 }) => void;

package/dist/contract/cli/invokeRun.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.invokeRun = void 0;
 const helpful_errors_1 = require("helpful-errors");
+const genActor_1 = require("../../domain.operations/actor/genActor");
 const executeSkill_1 = require("../../domain.operations/invoke/executeSkill");
 const findUniqueSkillExecutable_1 = require("../../domain.operations/invoke/findUniqueSkillExecutable");
 /**
@@ -15,38 +16,130 @@ const getRawArgsAfterRun = () => {
         return [];
     return argv.slice(runIdx + 1);
 };
+/**
+ * .what = performs run via actor-mode (typed solid skill on role)
+ * .why = executes a typed solid skill via actor.run with full type safety
+ */
+const performRunViaActorMode = async (input) => {
+    // create actor
+    const actor = (0, genActor_1.genActor)({ role: input.role, brains: input.brains });
+    // log which skill will run
+    console.log(``);
+    console.log(`🪨 skill "${input.opts.skill}" from role="${input.opts.role}"`);
+    console.log(``);
+    // parse skill input from remaining args
+    const rawArgs = getRawArgsAfterRun();
+    const skillArgs = parseArgsToObject(rawArgs, input.opts.skill);
+    // invoke actor.run
+    await actor.run({ skill: { [input.opts.skill]: skillArgs } });
+};
+/**
+ * .what = performs run via command-mode (shell skill discovery)
+ * .why = discovers and executes shell skills from .agent/ directories
+ */
+const performRunViaCommandMode = (input) => {
+    // discover skill via .agent/ dirs
+    const skill = (0, findUniqueSkillExecutable_1.findUniqueSkillExecutable)({
+        repoSlug: input.opts.repo,
+        roleSlug: input.opts.role,
+        skillSlug: input.opts.skill,
+    });
+    // log which skill will run
+    console.log(``);
+    console.log(`🪨 skill "${skill.slug}" from repo=${skill.repoSlug} role=${skill.roleSlug}`);
+    console.log(``);
+    // get all args after 'run' for passthrough
+    const rawArgs = getRawArgsAfterRun();
+    // execute with all args passed through
+    (0, executeSkill_1.executeSkill)({ skill, args: rawArgs });
+};
 /**
  * .what = adds the "run" command to the CLI
- * .why = discovers and executes skills from linked role directories
+ * .why = discovers and executes solid skills (deterministic, no brain)
  */
-const invokeRun = ({ program }) => {
+const invokeRun = ({ program, registries, brains, }) => {
     program
         .command('run')
-        .description('run a skill from linked role directories')
+        .description('run a solid skill (deterministic, no brain)')
         .option('-s, --skill <slug>', 'the skill to execute')
         .option('--repo <slug>', 'filter to specific repo')
-        .option('--role <slug>', 'filter to specific role')
+        .option('-r, --role <slug>', 'filter to specific role')
         .allowUnknownOption(true)
         .allowExcessArguments(true)
         .action(async (opts) => {
         // validate skill is provided
         if (!opts.skill)
             helpful_errors_1.BadRequestError.throw('--skill is required (e.g., --skill init.claude)');
-        // find unique skill
-        const skill = (0, findUniqueSkillExecutable_1.findUniqueSkillExecutable)({
-            repoSlug: opts.repo,
-            roleSlug: opts.role,
-            skillSlug: opts.skill,
-        });
-        // log which skill will run
-        console.log(``);
-        console.log(`🌊 skill "${skill.slug}" from repo=${skill.repoSlug} role=${skill.roleSlug}`);
-        console.log(``);
-        // get all args after 'run' for passthrough
-        const rawArgs = getRawArgsAfterRun();
-        // execute with all args passed through
-        (0, executeSkill_1.executeSkill)({ skill, args: rawArgs });
+        // determine which mode to use
+        const allRoles = registries.flatMap((r) => r.roles);
+        const roleFound = opts.role
+            ? allRoles.find((r) => r.slug === opts.role)
+            : undefined;
+        const hasTypedSolidSkill = roleFound?.skills?.solid?.[opts.skill] !== undefined;
+        const isActorMode = roleFound && hasTypedSolidSkill && brains.length > 0;
+        const isCommandMode = !isActorMode;
+        // 🪨 actor-mode: invoke typed solid skill via actor.run
+        if (isActorMode)
+            return await performRunViaActorMode({
+                opts: { skill: opts.skill, role: opts.role },
+                role: roleFound,
+                brains,
+            });
+        // 🐚 command-mode: discover and execute shell skill
+        if (isCommandMode)
+            return performRunViaCommandMode({
+                opts: { skill: opts.skill, repo: opts.repo, role: opts.role },
+            });
+        // neither mode matched - unexpected
+        throw new helpful_errors_1.UnexpectedCodePathError('invokeRun: neither actor-mode nor command-mode matched', { opts });
     });
 };
 exports.invokeRun = invokeRun;
+/**
+ * .what = parses raw CLI args into object for skill input
+ * .why = converts --key value pairs to { key: value } object
+ */
+const parseArgsToObject = (rawArgs, skillSlug) => {
+    const result = {};
+    let i = 0;
+    while (i < rawArgs.length) {
+        const arg = rawArgs[i];
+        // skip --skill, --role, --repo (already consumed)
+        if (arg === '--skill' ||
+            arg === '-s' ||
+            arg === '--role' ||
+            arg === '-r' ||
+            arg === '--repo') {
+            i += 2; // skip flag and its value
+            continue;
+        }
+        // skip the skill slug value if it matches
+        if (arg === skillSlug) {
+            i++;
+            continue;
+        }
+        // parse --key value or --key=value
+        if (arg.startsWith('--')) {
+            const eqIdx = arg.indexOf('=');
+            if (eqIdx > 0) {
+                // --key=value format
+                const key = arg.slice(2, eqIdx);
+                const value = arg.slice(eqIdx + 1);
+                result[key] = value;
+                i++;
+            }
+            else {
+                // --key value format
+                const key = arg.slice(2);
+                const value = rawArgs[i + 1] ?? '';
+                result[key] = value;
+                i += 2;
+            }
+        }
+        else {
+            i++;
+        }
+    }
+    return result;
+};
 //# sourceMappingURL=invokeRun.js.map

package/dist/contract/cli/invokeRun.js.map

@@ -1 +1 @@
-{"version":3,"file":"invokeRun.js","sourceRoot":"","sources":["../../../src/contract/cli/invokeRun.ts"],"names":[],"mappings":";;;AACA,mDAAiD;AAEjD,6EAA0E;AAC1E,uGAAoG;AAEpG;;;GAGG;AACH,MAAM,kBAAkB,GAAG,GAAa,EAAE;IACxC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,MAAM,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAChC,CAAC,CAAC;AAEF;;;GAGG;AACI,MAAM,SAAS,GAAG,CAAC,EAAE,OAAO,EAAwB,EAAQ,EAAE;IACnE,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CAAC,oBAAoB,EAAE,sBAAsB,CAAC;SACpD,MAAM,CAAC,eAAe,EAAE,yBAAyB,CAAC;SAClD,MAAM,CAAC,eAAe,EAAE,yBAAyB,CAAC;SAClD,kBAAkB,CAAC,IAAI,CAAC;SACxB,oBAAoB,CAAC,IAAI,CAAC;SAC1B,MAAM,CAAC,KAAK,EAAE,IAAsD,EAAE,EAAE;QACvE,6BAA6B;QAC7B,IAAI,CAAC,IAAI,CAAC,KAAK;YACb,gCAAe,CAAC,KAAK,CACnB,iDAAiD,CAClD,CAAC;QAEJ,oBAAoB;QACpB,MAAM,KAAK,GAAG,IAAA,qDAAyB,EAAC;YACtC,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,SAAS,EAAE,IAAI,CAAC,KAAK;SACtB,CAAC,CAAC;QAEH,2BAA2B;QAC3B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CACT,aAAa,KAAK,CAAC,IAAI,eAAe,KAAK,CAAC,QAAQ,SAAS,KAAK,CAAC,QAAQ,EAAE,CAC9E,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,2CAA2C;QAC3C,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;QAErC,uCAAuC;QACvC,IAAA,2BAAY,EAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AApCW,QAAA,SAAS,aAoCpB"}
+{"version":3,"file":"invokeRun.js","sourceRoot":"","sources":["../../../src/contract/cli/invokeRun.ts"],"names":[],"mappings":"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"}

package/dist/contract/sdk.d.ts

@@ -1,5 +1,8 @@
 export { withImmute } from 'domain-objects';
 export * from '../domain.objects';
+export { genActor } from '../domain.operations/actor/genActor';
+export { castBriefsToPrompt } from '../domain.operations/briefs/castBriefsToPrompt';
+export { genContextBrain } from '../domain.operations/context/genContextBrain';
 export { genContextStitchTrail } from '../domain.operations/context/genContextStitchTrail';
 export { enrollThread } from '../domain.operations/role/enrollThread';
 export { genRoleSkill } from '../domain.operations/role/genRoleSkill';

package/dist/contract/sdk.js

@@ -14,10 +14,16 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.enweaveOneStitcher = exports.genStitchRoute = exports.genStitchFanout = exports.genStitchCycle = exports.genStitchChoice = exports.asStitcherFlat = exports.asStitcher = exports.getStitch = exports.useTemplate = exports.getTemplateVarsFromRoleInherit = exports.getTemplateValFromArtifacts = exports.getTemplatePathByCallerPath = exports.genTemplate = exports.genStepImagineViaTemplate = exports.getRoleBriefs = exports.genRoleSkill = exports.enrollThread = exports.genContextStitchTrail = exports.withImmute = void 0;
+exports.enweaveOneStitcher = exports.genStitchRoute = exports.genStitchFanout = exports.genStitchCycle = exports.genStitchChoice = exports.asStitcherFlat = exports.asStitcher = exports.getStitch = exports.useTemplate = exports.getTemplateVarsFromRoleInherit = exports.getTemplateValFromArtifacts = exports.getTemplatePathByCallerPath = exports.genTemplate = exports.genStepImagineViaTemplate = exports.getRoleBriefs = exports.genRoleSkill = exports.enrollThread = exports.genContextStitchTrail = exports.genContextBrain = exports.castBriefsToPrompt = exports.genActor = exports.withImmute = void 0;
 var domain_objects_1 = require("domain-objects");
 Object.defineProperty(exports, "withImmute", { enumerable: true, get: function () { return domain_objects_1.withImmute; } });
 __exportStar(require("../domain.objects"), exports);
+var genActor_1 = require("../domain.operations/actor/genActor");
+Object.defineProperty(exports, "genActor", { enumerable: true, get: function () { return genActor_1.genActor; } });
+var castBriefsToPrompt_1 = require("../domain.operations/briefs/castBriefsToPrompt");
+Object.defineProperty(exports, "castBriefsToPrompt", { enumerable: true, get: function () { return castBriefsToPrompt_1.castBriefsToPrompt; } });
+var genContextBrain_1 = require("../domain.operations/context/genContextBrain");
+Object.defineProperty(exports, "genContextBrain", { enumerable: true, get: function () { return genContextBrain_1.genContextBrain; } });
 var genContextStitchTrail_1 = require("../domain.operations/context/genContextStitchTrail");
 Object.defineProperty(exports, "genContextStitchTrail", { enumerable: true, get: function () { return genContextStitchTrail_1.genContextStitchTrail; } });
 var enrollThread_1 = require("../domain.operations/role/enrollThread");

package/dist/contract/sdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../src/contract/sdk.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iDAA4C;AAAnC,4GAAA,UAAU,OAAA;AAEnB,sDAAoC;AACpC,8FAA6F;AAApF,8HAAA,qBAAqB,OAAA;AAC9B,yEAAwE;AAA/D,4GAAA,YAAY,OAAA;AACrB,yEAAwE;AAA/D,4GAAA,YAAY,OAAA;AACrB,2EAA0E;AAAjE,8GAAA,aAAa,OAAA;AAEtB,uGAAsG;AAA7F,sIAAA,yBAAyB,OAAA;AAClC,2EAA0E;AAAjE,0GAAA,WAAW,OAAA;AACpB,2GAA0G;AAAjG,0IAAA,2BAA2B,OAAA;AACpC,2GAA0G;AAAjG,0IAAA,2BAA2B,OAAA;AACpC,iHAAgH;AAAvG,gJAAA,8BAA8B,OAAA;AACvC,2EAA0E;AAAjE,0GAAA,WAAW,OAAA;AACpB,qEAAoE;AAA3D,sGAAA,SAAS,OAAA;AAClB,8EAA6E;AAApE,wGAAA,UAAU,OAAA;AACnB,sFAAqF;AAA5E,gHAAA,cAAc,OAAA;AACvB,wFAAuF;AAA9E,kHAAA,eAAe,OAAA;AACxB,sFAAqF;AAA5E,gHAAA,cAAc,OAAA;AACvB,wFAAuF;AAA9E,kHAAA,eAAe,OAAA;AACxB,sFAAqF;AAA5E,gHAAA,cAAc,OAAA;AACvB,sFAAqF;AAA5E,wHAAA,kBAAkB,OAAA"}
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../src/contract/sdk.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iDAA4C;AAAnC,4GAAA,UAAU,OAAA;AAEnB,sDAAoC;AACpC,kEAAiE;AAAxD,oGAAA,QAAQ,OAAA;AACjB,uFAAsF;AAA7E,wHAAA,kBAAkB,OAAA;AAC3B,kFAAiF;AAAxE,kHAAA,eAAe,OAAA;AACxB,8FAA6F;AAApF,8HAAA,qBAAqB,OAAA;AAC9B,yEAAwE;AAA/D,4GAAA,YAAY,OAAA;AACrB,yEAAwE;AAA/D,4GAAA,YAAY,OAAA;AACrB,2EAA0E;AAAjE,8GAAA,aAAa,OAAA;AAEtB,uGAAsG;AAA7F,sIAAA,yBAAyB,OAAA;AAClC,2EAA0E;AAAjE,0GAAA,WAAW,OAAA;AACpB,2GAA0G;AAAjG,0IAAA,2BAA2B,OAAA;AACpC,2GAA0G;AAAjG,0IAAA,2BAA2B,OAAA;AACpC,iHAAgH;AAAvG,gJAAA,8BAA8B,OAAA;AACvC,2EAA0E;AAAjE,0GAAA,WAAW,OAAA;AACpB,qEAAoE;AAA3D,sGAAA,SAAS,OAAA;AAClB,8EAA6E;AAApE,wGAAA,UAAU,OAAA;AACnB,sFAAqF;AAA5E,gHAAA,cAAc,OAAA;AACvB,wFAAuF;AAA9E,kHAAA,eAAe,OAAA;AACxB,sFAAqF;AAA5E,gHAAA,cAAc,OAAA;AACvB,wFAAuF;AAA9E,kHAAA,eAAe,OAAA;AACxB,sFAAqF;AAA5E,gHAAA,cAAc,OAAA;AACvB,sFAAqF;AAA5E,wHAAA,kBAAkB,OAAA"}