rhachet 1.17.0 → 1.19.0

package/dist/domain.objects/index.js

@@ -27,6 +27,11 @@ __exportStar(require("./Thread"), exports);
 __exportStar(require("./Threads"), exports);
 // export * from './Weave';
 // export * from './Weaver';
+__exportStar(require("./Actor"), exports);
+__exportStar(require("./ActorRoleSkill"), exports);
+__exportStar(require("./BrainAtom"), exports);
+__exportStar(require("./BrainRepl"), exports);
+__exportStar(require("./ContextBrain"), exports);
 __exportStar(require("./InvokeHooks"), exports);
 __exportStar(require("./InvokeOpts"), exports);
 __exportStar(require("./Role"), exports);

package/dist/domain.objects/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain.objects/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,iDAA+B;AAC/B,gDAA8B;AAC9B,6CAA2B;AAC3B,iDAA+B;AAC/B,gDAA8B;AAC9B,mDAAiC;AACjC,+CAA6B;AAC7B,gDAA8B;AAC9B,2CAAyB;AACzB,4CAA0B;AAE1B,2BAA2B;AAC3B,4BAA4B;AAE5B,gDAA8B;AAC9B,+CAA6B;AAC7B,yCAAuB;AACvB,gDAA8B;AAC9B,iDAA+B;AAC/B,8CAA4B;AAC5B,uDAAqC;AACrC,wDAAsC;AACtC,8CAA4B;AAC5B,6CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain.objects/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,iDAA+B;AAC/B,gDAA8B;AAC9B,6CAA2B;AAC3B,iDAA+B;AAC/B,gDAA8B;AAC9B,mDAAiC;AACjC,+CAA6B;AAC7B,gDAA8B;AAC9B,2CAAyB;AACzB,4CAA0B;AAE1B,2BAA2B;AAC3B,4BAA4B;AAE5B,0CAAwB;AACxB,mDAAiC;AACjC,8CAA4B;AAC5B,8CAA4B;AAC5B,iDAA+B;AAC/B,gDAA8B;AAC9B,+CAA6B;AAC7B,yCAAuB;AACvB,gDAA8B;AAC9B,iDAA+B;AAC/B,8CAA4B;AAC5B,uDAAqC;AACrC,wDAAsC;AACtC,8CAA4B;AAC5B,6CAA2B"}

package/dist/domain.operations/actor/actorAct.d.ts

@@ -0,0 +1,15 @@
+import type { ActorRoleSkill } from '../../domain.objects/ActorRoleSkill';
+import type { BrainRepl } from '../../domain.objects/BrainRepl';
+import type { Role } from '../../domain.objects/Role';
+/**
+ * .what = executes a rigid skill with a brain
+ * .why = deterministic harness with probabilistic brain operations
+ *
+ * .note = skill is pre-resolved by genActor; this just executes
+ */
+export declare const actorAct: (input: {
+    role: Role;
+    brain: BrainRepl;
+    skill: ActorRoleSkill;
+    args: Record<string, unknown>;
+}) => Promise<unknown>;

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

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.actorAct = void 0;
+const getRoleBriefs_1 = require("../../domain.operations/role/getRoleBriefs");
+/**
+ * .what = executes a rigid skill with a brain
+ * .why = deterministic harness with probabilistic brain operations
+ *
+ * .note = skill is pre-resolved by genActor; this just executes
+ */
+const actorAct = async (input) => {
+    // resolve briefs from role
+    const briefs = await (0, getRoleBriefs_1.getRoleBriefs)({
+        by: {
+            role: { name: input.role.slug },
+            briefs: { glob: '**/*' },
+        },
+    });
+    // execute rigid skill with brain
+    const result = await input.brain.act({
+        role: { briefs },
+        prompt: `Execute skill "${input.skill.slug}" with args: ${JSON.stringify(input.args)}`,
+        schema: {
+            output: input.skill.schema?.output ?? {},
+        },
+    });
+    return result;
+};
+exports.actorAct = actorAct;
+//# sourceMappingURL=actorAct.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actorAct.js","sourceRoot":"","sources":["../../../src/domain.operations/actor/actorAct.ts"],"names":[],"mappings":";;;AAGA,6EAA0E;AAE1E;;;;;GAKG;AACI,MAAM,QAAQ,GAAG,KAAK,EAAE,KAK9B,EAAoB,EAAE;IACrB,2BAA2B;IAC3B,MAAM,MAAM,GAAG,MAAM,IAAA,6BAAa,EAAC;QACjC,EAAE,EAAE;YACF,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;YAC/B,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SACzB;KACF,CAAC,CAAC;IAEH,iCAAiC;IACjC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;QACnC,IAAI,EAAE,EAAE,MAAM,EAAE;QAChB,MAAM,EAAE,kBAAkB,KAAK,CAAC,KAAK,CAAC,IAAI,gBAAgB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;QACtF,MAAM,EAAE;YACN,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,IAAK,EAAU;SAClD;KACF,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAxBW,QAAA,QAAQ,YAwBnB"}

package/dist/domain.operations/actor/actorAsk.d.ts

@@ -0,0 +1,15 @@
+import type { BrainRepl } from '../../domain.objects/BrainRepl';
+import type { Role } from '../../domain.objects/Role';
+/**
+ * .what = starts a fluid conversation with a brain
+ * .why = open-ended exploration, brain decides path
+ *
+ * todo: support --interactive mode for cli invocations
+ */
+export declare const actorAsk: (input: {
+    role: Role;
+    brain: BrainRepl;
+    prompt: string;
+}) => Promise<{
+    response: string;
+}>;

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

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.actorAsk = void 0;
+const zod_1 = require("zod");
+const getRoleBriefs_1 = require("../../domain.operations/role/getRoleBriefs");
+/**
+ * .what = starts a fluid conversation with a brain
+ * .why = open-ended exploration, brain decides path
+ *
+ * todo: support --interactive mode for cli invocations
+ */
+const actorAsk = async (input) => {
+    // resolve briefs from role
+    const briefs = await (0, getRoleBriefs_1.getRoleBriefs)({
+        by: {
+            role: { name: input.role.slug },
+            briefs: { glob: '**/*' },
+        },
+    });
+    // execute fluid conversation with brain
+    // note: openai requires object schema, so wrap response in object
+    const result = await input.brain.ask({
+        role: { briefs },
+        prompt: input.prompt,
+        schema: {
+            output: zod_1.z.object({ response: zod_1.z.string() }),
+        },
+    });
+    return result;
+};
+exports.actorAsk = actorAsk;
+//# sourceMappingURL=actorAsk.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actorAsk.js","sourceRoot":"","sources":["../../../src/domain.operations/actor/actorAsk.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAIxB,6EAA0E;AAE1E;;;;;GAKG;AACI,MAAM,QAAQ,GAAG,KAAK,EAAE,KAI9B,EAAiC,EAAE;IAClC,2BAA2B;IAC3B,MAAM,MAAM,GAAG,MAAM,IAAA,6BAAa,EAAC;QACjC,EAAE,EAAE;YACF,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;YAC/B,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SACzB;KACF,CAAC,CAAC;IAEH,wCAAwC;IACxC,kEAAkE;IAClE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;QACnC,IAAI,EAAE,EAAE,MAAM,EAAE;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE;YACN,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,CAAC;SAC3C;KACF,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAxBW,QAAA,QAAQ,YAwBnB"}

package/dist/domain.operations/actor/actorRun.d.ts

@@ -0,0 +1,11 @@
+import type { ActorRoleSkill } from '../../domain.objects/ActorRoleSkill';
+/**
+ * .what = executes a solid skill via spawn
+ * .why = deterministic shell execution, no brain
+ *
+ * .note = skill is pre-resolved by genActor; this just executes
+ */
+export declare const actorRun: (input: {
+    skill: ActorRoleSkill;
+    args: Record<string, unknown>;
+}) => Promise<unknown>;

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

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.actorRun = void 0;
+const executeSkill_1 = require("../../domain.operations/invoke/executeSkill");
+/**
+ * .what = executes a solid skill via spawn
+ * .why = deterministic shell execution, no brain
+ *
+ * .note = skill is pre-resolved by genActor; this just executes
+ */
+const actorRun = async (input) => {
+    // convert skill args object to CLI args array
+    const argsArray = [];
+    for (const [key, value] of Object.entries(input.args)) {
+        argsArray.push(`--${key}`, String(value));
+    }
+    // execute skill via spawn
+    const result = await (0, executeSkill_1.executeSkill)({
+        skill: input.skill.executable,
+        args: argsArray,
+    });
+    return result;
+};
+exports.actorRun = actorRun;
+//# sourceMappingURL=actorRun.js.map

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

@@ -0,0 +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"}

package/dist/domain.operations/actor/findActorBrainInAllowlist.d.ts

@@ -0,0 +1,16 @@
+import type { BrainRepl } from '../../domain.objects/BrainRepl';
+/**
+ * .what = finds a brain in the actor's allowlist
+ * .why = validates that a requested brain is permitted by the actor
+ *
+ * .note = accepts either:
+ *   - ref: { repo, slug } for lookup by unique key
+ *   - direct BrainRepl instance for validation against allowlist
+ */
+export declare const findActorBrainInAllowlist: (input: {
+    brain: {
+        repo: string;
+        slug: string;
+    } | BrainRepl;
+    allowlist: BrainRepl[];
+}) => BrainRepl;

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

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findActorBrainInAllowlist = void 0;
+const helpful_errors_1 = require("helpful-errors");
+/**
+ * .what = finds a brain in the actor's allowlist
+ * .why = validates that a requested brain is permitted by the actor
+ *
+ * .note = accepts either:
+ *   - ref: { repo, slug } for lookup by unique key
+ *   - direct BrainRepl instance for validation against allowlist
+ */
+const findActorBrainInAllowlist = (input) => {
+    // extract repo and slug from brain (whether ref or instance)
+    const brainRef = {
+        repo: input.brain.repo,
+        slug: input.brain.slug,
+    };
+    // lookup brain in allowlist by unique key
+    const brainFound = input.allowlist.find((b) => b.repo === brainRef.repo && b.slug === brainRef.slug);
+    // fail if brain not in allowlist
+    if (!brainFound)
+        throw new helpful_errors_1.BadRequestError('brain not in actor allowlist', {
+            brainRef,
+            allowlistRefs: input.allowlist.map((b) => ({
+                repo: b.repo,
+                slug: b.slug,
+            })),
+        });
+    return brainFound;
+};
+exports.findActorBrainInAllowlist = findActorBrainInAllowlist;
+//# sourceMappingURL=findActorBrainInAllowlist.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findActorBrainInAllowlist.js","sourceRoot":"","sources":["../../../src/domain.operations/actor/findActorBrainInAllowlist.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAIjD;;;;;;;GAOG;AACI,MAAM,yBAAyB,GAAG,CAAC,KAGzC,EAAa,EAAE;IACd,6DAA6D;IAC7D,MAAM,QAAQ,GAAG;QACf,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;QACtB,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;KACvB,CAAC;IAEF,0CAA0C;IAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CACrC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAC5D,CAAC;IAEF,iCAAiC;IACjC,IAAI,CAAC,UAAU;QACb,MAAM,IAAI,gCAAe,CAAC,8BAA8B,EAAE;YACxD,QAAQ;YACR,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACzC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;aACb,CAAC,CAAC;SACJ,CAAC,CAAC;IAEL,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AA1BW,QAAA,yBAAyB,6BA0BpC"}

package/dist/domain.operations/actor/findActorRoleSkillBySlug.d.ts

@@ -0,0 +1,13 @@
+import { ActorRoleSkill } from '../../domain.objects/ActorRoleSkill';
+import type { Role } from '../../domain.objects/Role';
+/**
+ * .what = finds a skill by slug for a role
+ * .why = resolves skill from role.skills[route] or .agent/ dirs
+ *
+ * .note = role.skills[route] takes precedence over .agent/ dirs (usecase.8)
+ */
+export declare const findActorRoleSkillBySlug: (input: {
+    slug: string;
+    role: Role;
+    route: 'solid' | 'rigid';
+}) => ActorRoleSkill;

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

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findActorRoleSkillBySlug = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const ActorRoleSkill_1 = require("../../domain.objects/ActorRoleSkill");
+const discoverSkillExecutables_1 = require("../../domain.operations/invoke/discoverSkillExecutables");
+/**
+ * .what = finds a skill by slug for a role
+ * .why = resolves skill from role.skills[route] or .agent/ dirs
+ *
+ * .note = role.skills[route] takes precedence over .agent/ dirs (usecase.8)
+ */
+const findActorRoleSkillBySlug = (input) => {
+    // check role.skills[route] first (takes precedence per usecase.8)
+    const skillsForRoute = input.route === 'solid' ? input.role.skills.solid : input.role.skills.rigid;
+    // lookup schema from role.skills[route]
+    const skillSchema = skillsForRoute?.[input.slug];
+    if (skillSchema) {
+        // find executable from .agent/ dirs (skill schema defines type, but executable runs)
+        const executables = (0, discoverSkillExecutables_1.discoverSkillExecutables)({
+            roleSlug: input.role.slug,
+            skillSlug: input.slug,
+        });
+        // fail fast if skill is declared but no executable found
+        if (executables.length === 0)
+            throw new helpful_errors_1.BadRequestError(`skill "${input.slug}" declared in role.skills.${input.route} but no executable found in .agent/`, {
+                skillSlug: input.slug,
+                roleSlug: input.role.slug,
+                route: input.route,
+                hint: `create .agent/repo=.this/role=${input.role.slug}/skills/${input.slug}.sh`,
+            });
+        return new ActorRoleSkill_1.ActorRoleSkill({
+            slug: input.slug,
+            route: input.route,
+            source: 'role.skills',
+            schema: skillSchema,
+            executable: executables[0],
+        });
+    }
+    // fall back to .agent/ discovery (executable exists but no schema)
+    const executables = (0, discoverSkillExecutables_1.discoverSkillExecutables)({
+        roleSlug: input.role.slug,
+        skillSlug: input.slug,
+    });
+    // executable exists but no schema = not usable via actor contracts
+    if (executables.length > 0)
+        throw new helpful_errors_1.BadRequestError(`skill "${input.slug}" found in .agent/ but lacks schema in role.skills.${input.route}`, {
+            skillSlug: input.slug,
+            roleSlug: input.role.slug,
+            route: input.route,
+            hint: `add schema to role.skills.${input.route}.${input.slug} to use via actor contracts`,
+            executable: executables[0],
+        });
+    // skill not found
+    throw new helpful_errors_1.BadRequestError(`skill not found: ${input.slug}`, {
+        skillSlug: input.slug,
+        roleSlug: input.role.slug,
+        route: input.route,
+        availableSolidSkills: input.role.skills.solid
+            ? Object.keys(input.role.skills.solid)
+            : [],
+        availableRigidSkills: input.role.skills.rigid
+            ? Object.keys(input.role.skills.rigid)
+            : [],
+    });
+};
+exports.findActorRoleSkillBySlug = findActorRoleSkillBySlug;
+//# sourceMappingURL=findActorRoleSkillBySlug.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findActorRoleSkillBySlug.js","sourceRoot":"","sources":["../../../src/domain.operations/actor/findActorRoleSkillBySlug.ts"],"names":[],"mappings":"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"}

package/dist/domain.operations/actor/genActor.d.ts

@@ -0,0 +1,18 @@
+import { Actor } from '../../domain.objects/Actor';
+import type { BrainRepl } from '../../domain.objects/BrainRepl';
+import type { Role } from '../../domain.objects/Role';
+/**
+ * .what = creates an actor from a role and brain allowlist
+ * .why = composes role (skills + briefs) with brains for type-safe invocation
+ *
+ * .note =
+ *   - first brain in allowlist is the default
+ *   - .act() uses default brain when none specified
+ *   - .act() validates brain against allowlist when specified
+ *   - .run() executes solid skills without brain
+ *   - .ask() starts fluid conversation with default brain
+ */
+export declare const genActor: <TRole extends Role<import("../../domain.objects/Role").RoleSkillRegistry, import("../../domain.objects/Role").RoleSkillRegistry>>(input: {
+    role: TRole;
+    brains: BrainRepl[];
+}) => Actor<TRole>;

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

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genActor = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const Actor_1 = require("../../domain.objects/Actor");
+const actorAct_1 = require("./actorAct");
+const actorAsk_1 = require("./actorAsk");
+const actorRun_1 = require("./actorRun");
+const findActorBrainInAllowlist_1 = require("./findActorBrainInAllowlist");
+const findActorRoleSkillBySlug_1 = require("./findActorRoleSkillBySlug");
+/**
+ * .what = creates an actor from a role and brain allowlist
+ * .why = composes role (skills + briefs) with brains for type-safe invocation
+ *
+ * .note =
+ *   - first brain in allowlist is the default
+ *   - .act() uses default brain when none specified
+ *   - .act() validates brain against allowlist when specified
+ *   - .run() executes solid skills without brain
+ *   - .ask() starts fluid conversation with default brain
+ */
+const genActor = (input) => {
+    // validate that at least one brain is provided
+    if (input.brains.length === 0)
+        throw new helpful_errors_1.BadRequestError('genActor requires at least one brain in allowlist', { roleSlug: input.role.slug });
+    // extract default brain (first in list)
+    const defaultBrain = input.brains[0];
+    // create bound .act() method with strong types
+    const act = async (actInput) => {
+        // resolve brain: use provided or default to first
+        const brainResolved = actInput.brain
+            ? (0, findActorBrainInAllowlist_1.findActorBrainInAllowlist)({
+                brain: actInput.brain,
+                allowlist: input.brains,
+            })
+            : defaultBrain;
+        // extract skill slug and args from skill object
+        const entries = Object.entries(actInput.skill);
+        if (entries.length !== 1)
+            throw new helpful_errors_1.BadRequestError('actor.act expects exactly one skill entry', {
+                entriesCount: entries.length,
+            });
+        const [skillSlug, skillArgs] = entries[0];
+        // resolve skill from role
+        const skillResolved = (0, findActorRoleSkillBySlug_1.findActorRoleSkillBySlug)({
+            slug: skillSlug,
+            role: input.role,
+            route: 'rigid',
+        });
+        // delegate to actorAct with pre-resolved skill
+        return (0, actorAct_1.actorAct)({
+            role: input.role,
+            brain: brainResolved,
+            skill: skillResolved,
+            args: skillArgs,
+        });
+    };
+    // create bound .run() method with strong types
+    const run = async (runInput) => {
+        // extract skill slug and args from skill object
+        const entries = Object.entries(runInput.skill);
+        if (entries.length !== 1)
+            throw new helpful_errors_1.BadRequestError('actor.run expects exactly one skill entry', {
+                entriesCount: entries.length,
+            });
+        const [skillSlug, skillArgs] = entries[0];
+        // resolve skill from role
+        const skillResolved = (0, findActorRoleSkillBySlug_1.findActorRoleSkillBySlug)({
+            slug: skillSlug,
+            role: input.role,
+            route: 'solid',
+        });
+        // delegate to actorRun with pre-resolved skill
+        return (0, actorRun_1.actorRun)({
+            skill: skillResolved,
+            args: skillArgs,
+        });
+    };
+    // create bound .ask() method
+    const ask = async (askInput) => {
+        // delegate to actorAsk with default brain
+        return (0, actorAsk_1.actorAsk)({
+            role: input.role,
+            brain: defaultBrain,
+            prompt: askInput.prompt,
+        });
+    };
+    // return actor with bound methods via Actor.typed() for strong type preservation
+    return Actor_1.Actor.typed({
+        role: input.role,
+        brains: input.brains,
+        act,
+        run,
+        ask,
+    });
+};
+exports.genActor = genActor;
+//# sourceMappingURL=genActor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"genActor.js","sourceRoot":"","sources":["../../../src/domain.operations/actor/genActor.ts"],"names":[],"mappings":"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"}

package/dist/domain.operations/brainAtom/askViaBrainAtom.d.ts

@@ -0,0 +1,22 @@
+import type { Artifact } from 'rhachet-artifact';
+import type { GitFile } from 'rhachet-artifact-git';
+import type { Empty } from 'type-fns';
+import type { z } from 'zod';
+import type { BrainAtom } from '../../domain.objects/BrainAtom';
+import type { BrainAtomPlugs } from '../../domain.objects/BrainAtomPlugs';
+/**
+ * .what = invoke a brain atom for single-turn inference
+ * .why = provides the core operation for atom-based imagination
+ *   with automatic role brief embedding and schema enforcement
+ */
+export declare const askViaBrainAtom: <TOutput>(input: {
+    atom: BrainAtom;
+    plugs?: BrainAtomPlugs;
+    role: {
+        briefs?: Artifact<typeof GitFile>[];
+    };
+    prompt: string;
+    schema: {
+        output: z.Schema<TOutput>;
+    };
+}, context?: Empty) => Promise<TOutput>;

package/dist/domain.operations/brainAtom/askViaBrainAtom.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askViaBrainAtom = void 0;
+/**
+ * .what = invoke a brain atom for single-turn inference
+ * .why = provides the core operation for atom-based imagination
+ *   with automatic role brief embedding and schema enforcement
+ */
+const askViaBrainAtom = async (input, context) => {
+    // delegate to the atom's ask implementation
+    return input.atom.ask({
+        plugs: input.plugs,
+        role: input.role,
+        prompt: input.prompt,
+        schema: input.schema,
+    }, context);
+};
+exports.askViaBrainAtom = askViaBrainAtom;
+//# sourceMappingURL=askViaBrainAtom.js.map

package/dist/domain.operations/brainAtom/askViaBrainAtom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askViaBrainAtom.js","sourceRoot":"","sources":["../../../src/domain.operations/brainAtom/askViaBrainAtom.ts"],"names":[],"mappings":";;;AAQA;;;;GAIG;AACI,MAAM,eAAe,GAAG,KAAK,EAClC,KAMC,EACD,OAAe,EACG,EAAE;IACpB,4CAA4C;IAC5C,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CACnB;QACE,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,EACD,OAAO,CACR,CAAC;AACJ,CAAC,CAAC;AApBW,QAAA,eAAe,mBAoB1B"}

package/dist/domain.operations/brainRepl/actViaBrainRepl.d.ts

@@ -0,0 +1,26 @@
+import type { Artifact } from 'rhachet-artifact';
+import type { GitFile } from 'rhachet-artifact-git';
+import type { Empty } from 'type-fns';
+import type { z } from 'zod';
+import type { BrainRepl } from '../../domain.objects/BrainRepl';
+import type { BrainReplPlugs } from '../../domain.objects/BrainReplPlugs';
+/**
+ * .what = invoke a brain repl for read+write agentic actions
+ * .why = provides full agentic capabilities for code changes,
+ *   file edits, and command execution tasks
+ *
+ * .sdk.implementation =
+ *   - claude-agent-sdk: query() with allowedTools=["Read","Edit","Write","Bash",...]
+ *   - codex-sdk: thread.run() with sandbox=workspace-write
+ */
+export declare const actViaBrainRepl: <TOutput>(input: {
+    repl: BrainRepl;
+    plugs?: BrainReplPlugs;
+    role: {
+        briefs?: Artifact<typeof GitFile>[];
+    };
+    prompt: string;
+    schema: {
+        output: z.Schema<TOutput>;
+    };
+}, context?: Empty) => Promise<TOutput>;

package/dist/domain.operations/brainRepl/actViaBrainRepl.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.actViaBrainRepl = void 0;
+/**
+ * .what = invoke a brain repl for read+write agentic actions
+ * .why = provides full agentic capabilities for code changes,
+ *   file edits, and command execution tasks
+ *
+ * .sdk.implementation =
+ *   - claude-agent-sdk: query() with allowedTools=["Read","Edit","Write","Bash",...]
+ *   - codex-sdk: thread.run() with sandbox=workspace-write
+ */
+const actViaBrainRepl = async (input, context) => {
+    // delegate to the repl's act implementation
+    return input.repl.act({
+        plugs: input.plugs,
+        role: input.role,
+        prompt: input.prompt,
+        schema: input.schema,
+    }, context);
+};
+exports.actViaBrainRepl = actViaBrainRepl;
+//# sourceMappingURL=actViaBrainRepl.js.map

package/dist/domain.operations/brainRepl/actViaBrainRepl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actViaBrainRepl.js","sourceRoot":"","sources":["../../../src/domain.operations/brainRepl/actViaBrainRepl.ts"],"names":[],"mappings":";;;AAQA;;;;;;;;GAQG;AACI,MAAM,eAAe,GAAG,KAAK,EAClC,KAMC,EACD,OAAe,EACG,EAAE;IACpB,4CAA4C;IAC5C,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CACnB;QACE,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,EACD,OAAO,CACR,CAAC;AACJ,CAAC,CAAC;AApBW,QAAA,eAAe,mBAoB1B"}

package/dist/domain.operations/brainRepl/askViaBrainRepl.d.ts

@@ -0,0 +1,26 @@
+import type { Artifact } from 'rhachet-artifact';
+import type { GitFile } from 'rhachet-artifact-git';
+import type { Empty } from 'type-fns';
+import type { z } from 'zod';
+import type { BrainRepl } from '../../domain.objects/BrainRepl';
+import type { BrainReplPlugs } from '../../domain.objects/BrainReplPlugs';
+/**
+ * .what = invoke a brain repl for readonly agentic analysis
+ * .why = provides safe, non-mutating agent interactions for research,
+ *   code analysis, and information gathering tasks
+ *
+ * .sdk.implementation =
+ *   - claude-agent-sdk: query() with disallowedTools=["Edit","Write","Bash"]
+ *   - codex-sdk: thread.run() with sandbox=read-only
+ */
+export declare const askViaBrainRepl: <TOutput>(input: {
+    repl: BrainRepl;
+    plugs?: BrainReplPlugs;
+    role: {
+        briefs?: Artifact<typeof GitFile>[];
+    };
+    prompt: string;
+    schema: {
+        output: z.Schema<TOutput>;
+    };
+}, context?: Empty) => Promise<TOutput>;

package/dist/domain.operations/brainRepl/askViaBrainRepl.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askViaBrainRepl = void 0;
+/**
+ * .what = invoke a brain repl for readonly agentic analysis
+ * .why = provides safe, non-mutating agent interactions for research,
+ *   code analysis, and information gathering tasks
+ *
+ * .sdk.implementation =
+ *   - claude-agent-sdk: query() with disallowedTools=["Edit","Write","Bash"]
+ *   - codex-sdk: thread.run() with sandbox=read-only
+ */
+const askViaBrainRepl = async (input, context) => {
+    // delegate to the repl's ask implementation
+    return input.repl.ask({
+        plugs: input.plugs,
+        role: input.role,
+        prompt: input.prompt,
+        schema: input.schema,
+    }, context);
+};
+exports.askViaBrainRepl = askViaBrainRepl;
+//# sourceMappingURL=askViaBrainRepl.js.map

package/dist/domain.operations/brainRepl/askViaBrainRepl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askViaBrainRepl.js","sourceRoot":"","sources":["../../../src/domain.operations/brainRepl/askViaBrainRepl.ts"],"names":[],"mappings":";;;AAQA;;;;;;;;GAQG;AACI,MAAM,eAAe,GAAG,KAAK,EAClC,KAMC,EACD,OAAe,EACG,EAAE;IACpB,4CAA4C;IAC5C,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CACnB;QACE,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,EACD,OAAO,CACR,CAAC;AACJ,CAAC,CAAC;AApBW,QAAA,eAAe,mBAoB1B"}

package/dist/domain.operations/briefs/castBriefsToPrompt.d.ts

@@ -0,0 +1,13 @@
+import type { Artifact } from 'rhachet-artifact';
+import type { GitFile } from 'rhachet-artifact-git';
+/**
+ * .what = converts briefs artifacts to concatenated prompt text
+ * .why = utility for plugin authors to easily compose briefs into system prompts
+ *
+ * .note = generalized from bootRoleResources logic;
+ *   bootRoleResources should be refactored to use this shared utility,
+ *   ensuring consistent briefs handling across boot and brain.imagine
+ */
+export declare const castBriefsToPrompt: (input: {
+    briefs: Artifact<typeof GitFile>[];
+}) => Promise<string>;

package/dist/domain.operations/briefs/castBriefsToPrompt.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.castBriefsToPrompt = void 0;
+/**
+ * .what = converts briefs artifacts to concatenated prompt text
+ * .why = utility for plugin authors to easily compose briefs into system prompts
+ *
+ * .note = generalized from bootRoleResources logic;
+ *   bootRoleResources should be refactored to use this shared utility,
+ *   ensuring consistent briefs handling across boot and brain.imagine
+ */
+const castBriefsToPrompt = async (input) => {
+    // resolve all artifacts to get their content
+    const contents = await Promise.all(input.briefs.map(async (brief) => {
+        const file = await brief.get();
+        return file?.content;
+    }));
+    return contents.filter(Boolean).join('\n\n');
+};
+exports.castBriefsToPrompt = castBriefsToPrompt;
+//# sourceMappingURL=castBriefsToPrompt.js.map

package/dist/domain.operations/briefs/castBriefsToPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"castBriefsToPrompt.js","sourceRoot":"","sources":["../../../src/domain.operations/briefs/castBriefsToPrompt.ts"],"names":[],"mappings":";;;AAGA;;;;;;;GAOG;AACI,MAAM,kBAAkB,GAAG,KAAK,EAAE,KAExC,EAAmB,EAAE;IACpB,6CAA6C;IAC7C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC/B,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC;QAC/B,OAAO,IAAI,EAAE,OAAO,CAAC;IACvB,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC,CAAC;AAZW,QAAA,kBAAkB,sBAY7B"}