rhachet 1.17.0 → 1.18.0

package/dist/contract/sdk.js

@@ -14,10 +14,14 @@ 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.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 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,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"}

package/dist/domain.objects/BrainAtom.d.ts

@@ -0,0 +1,54 @@
+import { DomainEntity } from 'domain-objects';
+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 { BrainAtomPlugs } from './BrainAtomPlugs';
+/**
+ * .what = an LLM inference endpoint capable of creative language imagination
+ * .why =
+ *   - enables registration of pluggable LLM atoms (e.g., claude, gpt, llama)
+ *   - provides a standardized contract for single-turn or multi-turn inference
+ *   - enables dynamic swapping of models at runtime
+ */
+export interface BrainAtom {
+    /**
+     * .what = identifier for the plugin package that provides this atom
+     * .example = "anthropic", "openai", "ollama"
+     */
+    repo: string;
+    /**
+     * .what = unique identifier for this specific atom within the repo
+     * .example = "claude-opus-4.5", "gpt-4o", "llama-3-70b"
+     */
+    slug: string;
+    /**
+     * .what = human-readable description of this atom's capabilities
+     * .why = helps developers understand what this atom is best suited for
+     */
+    description: string;
+    /**
+     * .what = the ask operation contract (renamed from imagine)
+     * .why = standardizes how all atoms are invoked, regardless of provider
+     *
+     * .note = plugin is responsible for handling role.briefs appropriately.
+     *   this design maximizes leverage of each brain's unique capabilities:
+     *   - context window optimization (e.g., claude's 200k vs gpt's 128k)
+     *   - provider-specific caching (e.g., anthropic prompt caching)
+     *   - finetuned behaviors (e.g., system prompt placement, formatting)
+     *   - native JSON schema enforcement for structured outputs
+     */
+    ask: <TOutput>(input: {
+        plugs?: BrainAtomPlugs;
+        role: {
+            briefs?: Artifact<typeof GitFile>[];
+        };
+        prompt: string;
+        schema: {
+            output: z.Schema<TOutput>;
+        };
+    }, context?: Empty) => Promise<TOutput>;
+}
+export declare class BrainAtom extends DomainEntity<BrainAtom> implements BrainAtom {
+    static unique: readonly ["repo", "slug"];
+}

package/dist/domain.objects/BrainAtom.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrainAtom = void 0;
+const domain_objects_1 = require("domain-objects");
+class BrainAtom extends domain_objects_1.DomainEntity {
+}
+exports.BrainAtom = BrainAtom;
+BrainAtom.unique = ['repo', 'slug'];
+//# sourceMappingURL=BrainAtom.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BrainAtom.js","sourceRoot":"","sources":["../../src/domain.objects/BrainAtom.ts"],"names":[],"mappings":";;;AAAA,mDAA8C;AAuD9C,MAAa,SAAU,SAAQ,6BAAuB;;AAAtD,8BAEC;AADe,gBAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAU,CAAC"}

package/dist/domain.objects/BrainAtomPlugs.d.ts

@@ -0,0 +1,17 @@
+import { DomainLiteral } from 'domain-objects';
+/**
+ * .what = configuration plugs for BrainAtom instances
+ * .why = enables extensible configuration for single-turn inference
+ *   without coupling to specific SDK implementations
+ *
+ * .note = placeholder interface; actual configuration TBD
+ */
+export interface BrainAtomPlugs {
+    /**
+     * .what = structured output configuration
+     * .why = enables native JSON schema enforcement for reduced token waste
+     */
+    output?: never;
+}
+export declare class BrainAtomPlugs extends DomainLiteral<BrainAtomPlugs> implements BrainAtomPlugs {
+}

package/dist/domain.objects/BrainAtomPlugs.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrainAtomPlugs = void 0;
+const domain_objects_1 = require("domain-objects");
+class BrainAtomPlugs extends domain_objects_1.DomainLiteral {
+}
+exports.BrainAtomPlugs = BrainAtomPlugs;
+//# sourceMappingURL=BrainAtomPlugs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BrainAtomPlugs.js","sourceRoot":"","sources":["../../src/domain.objects/BrainAtomPlugs.ts"],"names":[],"mappings":";;;AAAA,mDAA+C;AAiB/C,MAAa,cACX,SAAQ,8BAA6B;CACT;AAF9B,wCAE8B"}

package/dist/domain.objects/BrainRepl.d.ts

@@ -0,0 +1,74 @@
+import { DomainEntity } from 'domain-objects';
+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 { BrainReplPlugs } from './BrainReplPlugs';
+/**
+ * .what = a brain.atom operating behind a REPL (read-execute-print-loop)
+ * .why =
+ *   - enables registration of pluggable agentic repls (e.g., claude-code, codex)
+ *   - provides a standardized contract for agentic tool-using inference
+ *   - enables dynamic swapping of agentic systems at runtime
+ *
+ * .note = repls differ from atoms in that they execute iterative agentic loops
+ *   with tool use, rather than single-turn inference
+ */
+export interface BrainRepl {
+    /**
+     * .what = identifier for the plugin package that provides this repl
+     * .example = "anthropic", "openai"
+     */
+    repo: string;
+    /**
+     * .what = unique identifier for this specific repl within the repo
+     * .example = "claude-code", "codex"
+     */
+    slug: string;
+    /**
+     * .what = human-readable description of this repl's capabilities
+     * .why = helps developers understand what this repl is best suited for
+     */
+    description: string;
+    /**
+     * .what = readonly analysis operation (research, queries, code review)
+     * .why = provides safe, non-mutating agent interactions
+     *   with only read access to filesystem and tools
+     *
+     * .sdk.mapping =
+     *   - claude-agent-sdk: disallowedTools=["Edit","Write","Bash","NotebookEdit"]
+     *   - codex-sdk: --sandbox read-only
+     */
+    ask: <TOutput>(input: {
+        plugs?: BrainReplPlugs;
+        role: {
+            briefs?: Artifact<typeof GitFile>[];
+        };
+        prompt: string;
+        schema: {
+            output: z.Schema<TOutput>;
+        };
+    }, context?: Empty) => Promise<TOutput>;
+    /**
+     * .what = read+write action operation (code changes, file edits)
+     * .why = provides full agentic capabilities with write access
+     *   for tasks that require modifying the codebase
+     *
+     * .sdk.mapping =
+     *   - claude-agent-sdk: allowedTools=["Read","Edit","Write","Bash","Glob","Grep"]
+     *   - codex-sdk: --sandbox workspace-write
+     */
+    act: <TOutput>(input: {
+        plugs?: BrainReplPlugs;
+        role: {
+            briefs?: Artifact<typeof GitFile>[];
+        };
+        prompt: string;
+        schema: {
+            output: z.Schema<TOutput>;
+        };
+    }, context?: Empty) => Promise<TOutput>;
+}
+export declare class BrainRepl extends DomainEntity<BrainRepl> implements BrainRepl {
+    static unique: readonly ["repo", "slug"];
+}

package/dist/domain.objects/BrainRepl.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrainRepl = void 0;
+const domain_objects_1 = require("domain-objects");
+class BrainRepl extends domain_objects_1.DomainEntity {
+}
+exports.BrainRepl = BrainRepl;
+BrainRepl.unique = ['repo', 'slug'];
+//# sourceMappingURL=BrainRepl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BrainRepl.js","sourceRoot":"","sources":["../../src/domain.objects/BrainRepl.ts"],"names":[],"mappings":";;;AAAA,mDAA8C;AA2E9C,MAAa,SAAU,SAAQ,6BAAuB;;AAAtD,8BAEC;AADe,gBAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAU,CAAC"}

package/dist/domain.objects/BrainReplPlugs.d.ts

@@ -0,0 +1,34 @@
+import { DomainLiteral } from 'domain-objects';
+/**
+ * .what = configuration plugs for BrainRepl instances
+ * .why = enables extensible tooling, memory management, and access control
+ *   for agentic workloads without coupling to specific SDK implementations
+ */
+export interface BrainReplPlugs {
+    /**
+     * .what = additional tool providers beyond built-in tools
+     * .why = enables domain-specific tooling (databases, browsers, APIs)
+     *   via MCP servers or custom tool definitions
+     *
+     * .example = playwright browser, postgres database, custom APIs
+     */
+    toolboxes?: never;
+    /**
+     * .what = memory and context management strategy
+     * .why = enables custom context compression, session persistence,
+     *   and artifact management for long-running workflows
+     *
+     * .example = session resume, context compaction hooks
+     */
+    memory?: never;
+    /**
+     * .what = permission guard and access control
+     * .why = enables custom authorization logic, audit logging,
+     *   and tool-level access policies beyond SDK defaults
+     *
+     * .example = canUseTool callbacks, preToolUse hooks
+     */
+    access?: never;
+}
+export declare class BrainReplPlugs extends DomainLiteral<BrainReplPlugs> implements BrainReplPlugs {
+}

package/dist/domain.objects/BrainReplPlugs.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrainReplPlugs = void 0;
+const domain_objects_1 = require("domain-objects");
+class BrainReplPlugs extends domain_objects_1.DomainLiteral {
+}
+exports.BrainReplPlugs = BrainReplPlugs;
+//# sourceMappingURL=BrainReplPlugs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BrainReplPlugs.js","sourceRoot":"","sources":["../../src/domain.objects/BrainReplPlugs.ts"],"names":[],"mappings":";;;AAAA,mDAA+C;AAsC/C,MAAa,cACX,SAAQ,8BAA6B;CACT;AAF9B,wCAE8B"}

package/dist/domain.objects/ContextBrain.d.ts

@@ -0,0 +1,73 @@
+import { DomainLiteral, type RefByUnique } from 'domain-objects';
+import type { Artifact } from 'rhachet-artifact';
+import type { GitFile } from 'rhachet-artifact-git';
+import type { z } from 'zod';
+import type { BrainAtom } from './BrainAtom';
+import type { BrainAtomPlugs } from './BrainAtomPlugs';
+import type { BrainRepl } from './BrainRepl';
+import type { BrainReplPlugs } from './BrainReplPlugs';
+/**
+ * .what = runtime context providing unified access to brain atoms and repls
+ * .why =
+ *   - provides a clean interface for invoking brains by reference
+ *   - handles lookup, role embedding, and delegation transparently
+ *   - enables dynamic brain swapping without caller changes
+ */
+export interface ContextBrain {
+    /**
+     * .what = interface for invoking brain atoms and repls
+     */
+    brain: {
+        atom: {
+            /**
+             * .what = lookup and invoke a brain atom for single-turn inference
+             * .why = provides ergonomic access to atoms with automatic lookup
+             */
+            ask: <TOutput>(input: {
+                brain: RefByUnique<typeof BrainAtom>;
+                plugs?: BrainAtomPlugs;
+                role: {
+                    briefs?: Artifact<typeof GitFile>[];
+                };
+                prompt: string;
+                schema: {
+                    output: z.Schema<TOutput>;
+                };
+            }) => Promise<TOutput>;
+        };
+        repl: {
+            /**
+             * .what = lookup and invoke a brain repl for readonly analysis
+             * .why = provides safe agentic analysis without file modifications
+             */
+            ask: <TOutput>(input: {
+                brain: RefByUnique<typeof BrainRepl>;
+                plugs?: BrainReplPlugs;
+                role: {
+                    briefs?: Artifact<typeof GitFile>[];
+                };
+                prompt: string;
+                schema: {
+                    output: z.Schema<TOutput>;
+                };
+            }) => Promise<TOutput>;
+            /**
+             * .what = lookup and invoke a brain repl for read+write actions
+             * .why = provides full agentic capabilities with file modifications
+             */
+            act: <TOutput>(input: {
+                brain: RefByUnique<typeof BrainRepl>;
+                plugs?: BrainReplPlugs;
+                role: {
+                    briefs?: Artifact<typeof GitFile>[];
+                };
+                prompt: string;
+                schema: {
+                    output: z.Schema<TOutput>;
+                };
+            }) => Promise<TOutput>;
+        };
+    };
+}
+export declare class ContextBrain extends DomainLiteral<ContextBrain> implements ContextBrain {
+}

package/dist/domain.objects/ContextBrain.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextBrain = void 0;
+const domain_objects_1 = require("domain-objects");
+class ContextBrain extends domain_objects_1.DomainLiteral {
+}
+exports.ContextBrain = ContextBrain;
+//# sourceMappingURL=ContextBrain.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContextBrain.js","sourceRoot":"","sources":["../../src/domain.objects/ContextBrain.ts"],"names":[],"mappings":";;;AAAA,mDAAiE;AA+DjE,MAAa,YACX,SAAQ,8BAA2B;CACT;AAF5B,oCAE4B"}

package/dist/domain.objects/index.d.ts

@@ -9,6 +9,9 @@ export * from './StitchStep';
 export * from './StitchTrail';
 export * from './Thread';
 export * from './Threads';
+export * from './BrainAtom';
+export * from './BrainRepl';
+export * from './ContextBrain';
 export * from './InvokeHooks';
 export * from './InvokeOpts';
 export * from './Role';

package/dist/domain.objects/index.js

@@ -27,6 +27,9 @@ __exportStar(require("./Thread"), exports);
 __exportStar(require("./Threads"), exports);
 // export * from './Weave';
 // export * from './Weaver';
+__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,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/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"}

package/dist/domain.operations/context/findBrainAtomByRef.d.ts

@@ -0,0 +1,10 @@
+import type { RefByUnique } from 'domain-objects';
+import type { BrainAtom } from '../../domain.objects/BrainAtom';
+/**
+ * .what = finds a brain atom by its unique reference
+ * .why = enables lookup of registered atoms by { repo, slug }
+ */
+export declare const findBrainAtomByRef: (input: {
+    atoms: BrainAtom[];
+    ref: RefByUnique<typeof BrainAtom>;
+}) => BrainAtom;

package/dist/domain.operations/context/findBrainAtomByRef.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findBrainAtomByRef = void 0;
+const helpful_errors_1 = require("helpful-errors");
+/**
+ * .what = finds a brain atom by its unique reference
+ * .why = enables lookup of registered atoms by { repo, slug }
+ */
+const findBrainAtomByRef = (input) => {
+    // fail fast if no atoms available
+    if (input.atoms.length === 0)
+        throw new helpful_errors_1.BadRequestError('no atoms available in context', {
+            ref: input.ref,
+        });
+    // lookup atom by ref
+    const atomFound = input.atoms.find((a) => a.repo === input.ref.repo && a.slug === input.ref.slug);
+    // fail if not found
+    if (!atomFound)
+        throw new helpful_errors_1.BadRequestError('brain atom not found', { ref: input.ref });
+    return atomFound;
+};
+exports.findBrainAtomByRef = findBrainAtomByRef;
+//# sourceMappingURL=findBrainAtomByRef.js.map

package/dist/domain.operations/context/findBrainAtomByRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findBrainAtomByRef.js","sourceRoot":"","sources":["../../../src/domain.operations/context/findBrainAtomByRef.ts"],"names":[],"mappings":";;;AACA,mDAAiD;AAIjD;;;GAGG;AACI,MAAM,kBAAkB,GAAG,CAAC,KAGlC,EAAa,EAAE;IACd,kCAAkC;IAClC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM,IAAI,gCAAe,CAAC,+BAA+B,EAAE;YACzD,GAAG,EAAE,KAAK,CAAC,GAAG;SACf,CAAC,CAAC;IAEL,qBAAqB;IACrB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,CAC9D,CAAC;IAEF,oBAAoB;IACpB,IAAI,CAAC,SAAS;QACZ,MAAM,IAAI,gCAAe,CAAC,sBAAsB,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IAExE,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AApBW,QAAA,kBAAkB,sBAoB7B"}

package/dist/domain.operations/context/findBrainReplByRef.d.ts

@@ -0,0 +1,10 @@
+import type { RefByUnique } from 'domain-objects';
+import type { BrainRepl } from '../../domain.objects/BrainRepl';
+/**
+ * .what = finds a brain repl by its unique reference
+ * .why = enables lookup of registered repls by { repo, slug }
+ */
+export declare const findBrainReplByRef: (input: {
+    repls: BrainRepl[];
+    ref: RefByUnique<typeof BrainRepl>;
+}) => BrainRepl;