rhachet-roles-bhrain 0.3.0 → 0.5.2

package/dist/domain.objects/BrainArch1/BrainArch1ToolCall.js

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

package/dist/domain.objects/BrainArch1/BrainArch1ToolCall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrainArch1ToolCall.js","sourceRoot":"","sources":["../../../src/domain.objects/BrainArch1/BrainArch1ToolCall.ts"],"names":[],"mappings":";;;AAAA,mDAA+C;AAuB/C,MAAa,kBACX,SAAQ,8BAAiC;CACT;AAFlC,gDAEkC"}

package/dist/domain.objects/BrainArch1/BrainArch1ToolDefinition.d.ts

@@ -0,0 +1,54 @@
+import { DomainLiteral } from 'domain-objects';
+import type { z } from 'zod';
+import { type JsonSchema7ObjectType } from 'zod-to-json-schema';
+/**
+ * .what = json schema definition for tool parameters
+ * .why = enables llm to understand tool interface and generate valid calls
+ */
+export type BrainArch1ToolJsonSchema = JsonSchema7ObjectType;
+/**
+ * .what = schema container for tool input and output definitions
+ * .why = centralizes schema definitions and supports both zod and json schema
+ */
+export interface BrainArch1ToolSchema {
+    input: BrainArch1ToolJsonSchema;
+    output?: BrainArch1ToolJsonSchema;
+}
+/**
+ * .what = captures the schema definition of an available tool
+ * .why = enables llm to understand available tools and generate valid calls
+ */
+export interface BrainArch1ToolDefinition {
+    /**
+     * unique name of the tool
+     */
+    name: string;
+    /**
+     * human-readable description of what the tool does
+     */
+    description: string;
+    /**
+     * json schemas defining the tool's input and output parameters
+     */
+    schema: BrainArch1ToolSchema;
+    /**
+     * whether to enforce strict schema validation
+     */
+    strict: boolean;
+}
+export declare class BrainArch1ToolDefinition extends DomainLiteral<BrainArch1ToolDefinition> implements BrainArch1ToolDefinition {
+    static nested: {
+        schema: typeof DomainLiteral;
+    };
+}
+/**
+ * .what = extracts json schema from a zod object schema
+ * .why = enables defining tool schemas using zod for type safety and validation
+ *
+ * .note = only object schemas are supported. tool parameters must be objects.
+ */
+export declare const toJsonSchema: <T extends z.ZodObject<z.ZodRawShape, z.UnknownKeysParam, z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>>(zodSchema: T) => BrainArch1ToolJsonSchema;

package/dist/domain.objects/BrainArch1/BrainArch1ToolDefinition.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toJsonSchema = exports.BrainArch1ToolDefinition = void 0;
+const domain_objects_1 = require("domain-objects");
+const zod_to_json_schema_1 = require("zod-to-json-schema");
+class BrainArch1ToolDefinition extends domain_objects_1.DomainLiteral {
+}
+exports.BrainArch1ToolDefinition = BrainArch1ToolDefinition;
+BrainArch1ToolDefinition.nested = {
+    schema: domain_objects_1.DomainLiteral,
+};
+/**
+ * .what = extracts json schema from a zod object schema
+ * .why = enables defining tool schemas using zod for type safety and validation
+ *
+ * .note = only object schemas are supported. tool parameters must be objects.
+ */
+const toJsonSchema = (zodSchema) => (0, zod_to_json_schema_1.zodToJsonSchema)(zodSchema);
+exports.toJsonSchema = toJsonSchema;
+//# sourceMappingURL=BrainArch1ToolDefinition.js.map

package/dist/domain.objects/BrainArch1/BrainArch1ToolDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrainArch1ToolDefinition.js","sourceRoot":"","sources":["../../../src/domain.objects/BrainArch1/BrainArch1ToolDefinition.ts"],"names":[],"mappings":";;;AAAA,mDAA+C;AAE/C,2DAG4B;AA2C5B,MAAa,wBACX,SAAQ,8BAAuC;;AADjD,4DAOC;AAHe,+BAAM,GAAG;IACrB,MAAM,EAAE,8BAAa;CACtB,CAAC;AAGJ;;;;;GAKG;AACI,MAAM,YAAY,GAAG,CAC1B,SAAY,EACc,EAAE,CAC5B,IAAA,oCAAe,EAAC,SAAS,CAA0B,CAAC;AAHzC,QAAA,YAAY,gBAG6B"}

package/dist/domain.objects/BrainArch1/BrainArch1ToolExecutionCompletedEvent.d.ts

@@ -0,0 +1,36 @@
+import { DomainEvent } from 'domain-objects';
+import type { BrainArch1ToolCall } from './BrainArch1ToolCall';
+import type { BrainArch1ToolResult } from './BrainArch1ToolResult';
+/**
+ * .what = event emitted when a tool execution completes
+ * .why = enables observability and logging of tool usage
+ */
+export interface BrainArch1ToolExecutionCompletedEvent {
+    /**
+     * session uuid this event belongs to
+     */
+    sessionUuid: string;
+    /**
+     * iteration number when this tool was called
+     */
+    iterationNumber: number;
+    /**
+     * timestamp when this event occurred
+     */
+    occurredAt: string;
+    /**
+     * the tool call that was executed
+     */
+    call: BrainArch1ToolCall;
+    /**
+     * the result of the tool execution
+     */
+    result: BrainArch1ToolResult;
+    /**
+     * duration of execution in milliseconds
+     */
+    durationMs: number;
+}
+export declare class BrainArch1ToolExecutionCompletedEvent extends DomainEvent<BrainArch1ToolExecutionCompletedEvent> implements BrainArch1ToolExecutionCompletedEvent {
+    static unique: readonly ["sessionUuid", "call.id"];
+}

package/dist/domain.objects/BrainArch1/BrainArch1ToolExecutionCompletedEvent.js

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

package/dist/domain.objects/BrainArch1/BrainArch1ToolExecutionCompletedEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrainArch1ToolExecutionCompletedEvent.js","sourceRoot":"","sources":["../../../src/domain.objects/BrainArch1/BrainArch1ToolExecutionCompletedEvent.ts"],"names":[],"mappings":";;;AAAA,mDAA6C;AAyC7C,MAAa,qCACX,SAAQ,4BAAkD;;AAD5D,sFAKC;AADe,4CAAM,GAAG,CAAC,aAAa,EAAE,SAAS,CAAU,CAAC"}

package/dist/domain.objects/BrainArch1/BrainArch1ToolResult.d.ts

@@ -0,0 +1,25 @@
+import { DomainLiteral } from 'domain-objects';
+/**
+ * .what = captures the result of a tool execution
+ * .why = enables appending tool output to conversation context
+ */
+export interface BrainArch1ToolResult {
+    /**
+     * id of the tool call this result responds to
+     */
+    callId: string;
+    /**
+     * whether the tool execution succeeded
+     */
+    success: boolean;
+    /**
+     * output content from the tool (string for llm consumption)
+     */
+    output: string;
+    /**
+     * error message if execution failed
+     */
+    error: string | null;
+}
+export declare class BrainArch1ToolResult extends DomainLiteral<BrainArch1ToolResult> implements BrainArch1ToolResult {
+}

package/dist/domain.objects/BrainArch1/BrainArch1ToolResult.js

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

package/dist/domain.objects/BrainArch1/BrainArch1ToolResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrainArch1ToolResult.js","sourceRoot":"","sources":["../../../src/domain.objects/BrainArch1/BrainArch1ToolResult.ts"],"names":[],"mappings":";;;AAAA,mDAA+C;AA4B/C,MAAa,oBACX,SAAQ,8BAAmC;CACT;AAFpC,oDAEoC"}

package/dist/domain.objects/BrainArch1/BrainArch1Toolbox.d.ts

@@ -0,0 +1,31 @@
+import type { BrainArch1Context } from './BrainArch1Context';
+import type { BrainArch1ToolCall } from './BrainArch1ToolCall';
+import type { BrainArch1ToolDefinition } from './BrainArch1ToolDefinition';
+import type { BrainArch1ToolResult } from './BrainArch1ToolResult';
+/**
+ * .what = function signature for executing a tool call
+ * .why = enables toolboxes to define custom execution logic
+ */
+export type BrainArch1ToolExecuteFn = (input: {
+    call: BrainArch1ToolCall;
+}, context: BrainArch1Context) => Promise<BrainArch1ToolResult>;
+/**
+ * .what = interface for a toolbox plugin containing related tools
+ * .why = enables pluggable tool sets (files, bash, websearch) with unified interface
+ *
+ * .note = this is an interface, not a DomainLiteral, because it contains functions
+ */
+export interface BrainArch1Toolbox {
+    /**
+     * name of this toolbox (e.g., 'files', 'bash', 'websearch')
+     */
+    name: string;
+    /**
+     * tool definitions for all tools in this box
+     */
+    definitions: BrainArch1ToolDefinition[];
+    /**
+     * execute a tool call (routes to appropriate tool handler)
+     */
+    execute: BrainArch1ToolExecuteFn;
+}

package/dist/domain.objects/BrainArch1/BrainArch1Toolbox.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=BrainArch1Toolbox.js.map

package/dist/domain.objects/BrainArch1/BrainArch1Toolbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrainArch1Toolbox.js","sourceRoot":"","sources":["../../../src/domain.objects/BrainArch1/BrainArch1Toolbox.ts"],"names":[],"mappings":""}

package/dist/domain.objects/Reviewer/ReviewerReflectManifest.d.ts

@@ -0,0 +1,44 @@
+import { DomainLiteral } from 'domain-objects';
+import type { ReviewerReflectManifestOperation } from '../../domain.objects/Reviewer/ReviewerReflectManifestOperation';
+/**
+ * .what = manifest entry for a single pure rule proposal
+ * .why = captures the planned operation and paths for blend
+ */
+export interface ReviewerReflectManifestEntry {
+    /**
+     * path to the rule in pure/ directory
+     */
+    path: string;
+    /**
+     * operation to perform on this rule
+     */
+    operation: ReviewerReflectManifestOperation;
+    /**
+     * path in sync/ directory (if not OMIT)
+     */
+    syncPath?: string;
+    /**
+     * path to rule in target to merge from (if UPDATE/APPEND)
+     */
+    targetPath?: string;
+    /**
+     * justification for OMIT operations
+     */
+    reason?: string;
+}
+/**
+ * .what = manifest of planned operations for reviewer reflect blend
+ * .why = enables harness to execute blend plan from brain
+ */
+export interface ReviewerReflectManifest {
+    /**
+     * timestamp of when manifest was created
+     */
+    timestamp: string;
+    /**
+     * list of pure rules with their planned operations
+     */
+    pureRules: ReviewerReflectManifestEntry[];
+}
+export declare class ReviewerReflectManifest extends DomainLiteral<ReviewerReflectManifest> implements ReviewerReflectManifest {
+}

package/dist/domain.objects/Reviewer/ReviewerReflectManifest.js

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

package/dist/domain.objects/Reviewer/ReviewerReflectManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReviewerReflectManifest.js","sourceRoot":"","sources":["../../../src/domain.objects/Reviewer/ReviewerReflectManifest.ts"],"names":[],"mappings":";;;AAAA,mDAA+C;AAmD/C,MAAa,uBACX,SAAQ,8BAAsC;CACT;AAFvC,0DAEuC"}

package/dist/domain.objects/Reviewer/ReviewerReflectManifestOperation.d.ts

@@ -0,0 +1,30 @@
+/**
+ * .what = enum of manifest operation types for reviewer reflect blend
+ * .why = defines how pure proposals map to sync directory
+ */
+export declare enum ReviewerReflectManifestOperation {
+    /**
+     * skip rule, not copied to sync
+     * - duplicate of existing rule
+     * - not relevant to target domain
+     */
+    OMIT = "OMIT",
+    /**
+     * new rule, create in sync
+     * - no existing rule matches
+     * - path adapted to match target structure
+     */
+    SET_CREATE = "SET_CREATE",
+    /**
+     * merge with existing rule
+     * - existing rule covers same topic
+     * - content merged, not replaced
+     */
+    SET_UPDATE = "SET_UPDATE",
+    /**
+     * add as support document
+     * - extends existing rule with example/ref/lesson
+     * - suffix added: [demo], [ref], [lesson]
+     */
+    SET_APPEND = "SET_APPEND"
+}

package/dist/domain.objects/Reviewer/ReviewerReflectManifestOperation.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReviewerReflectManifestOperation = void 0;
+/**
+ * .what = enum of manifest operation types for reviewer reflect blend
+ * .why = defines how pure proposals map to sync directory
+ */
+var ReviewerReflectManifestOperation;
+(function (ReviewerReflectManifestOperation) {
+    /**
+     * skip rule, not copied to sync
+     * - duplicate of existing rule
+     * - not relevant to target domain
+     */
+    ReviewerReflectManifestOperation["OMIT"] = "OMIT";
+    /**
+     * new rule, create in sync
+     * - no existing rule matches
+     * - path adapted to match target structure
+     */
+    ReviewerReflectManifestOperation["SET_CREATE"] = "SET_CREATE";
+    /**
+     * merge with existing rule
+     * - existing rule covers same topic
+     * - content merged, not replaced
+     */
+    ReviewerReflectManifestOperation["SET_UPDATE"] = "SET_UPDATE";
+    /**
+     * add as support document
+     * - extends existing rule with example/ref/lesson
+     * - suffix added: [demo], [ref], [lesson]
+     */
+    ReviewerReflectManifestOperation["SET_APPEND"] = "SET_APPEND";
+})(ReviewerReflectManifestOperation || (exports.ReviewerReflectManifestOperation = ReviewerReflectManifestOperation = {}));
+//# sourceMappingURL=ReviewerReflectManifestOperation.js.map

package/dist/domain.objects/Reviewer/ReviewerReflectManifestOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReviewerReflectManifestOperation.js","sourceRoot":"","sources":["../../../src/domain.objects/Reviewer/ReviewerReflectManifestOperation.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,gCA4BX;AA5BD,WAAY,gCAAgC;IAC1C;;;;OAIG;IACH,iDAAa,CAAA;IAEb;;;;OAIG;IACH,6DAAyB,CAAA;IAEzB;;;;OAIG;IACH,6DAAyB,CAAA;IAEzB;;;;OAIG;IACH,6DAAyB,CAAA;AAC3B,CAAC,EA5BW,gCAAgC,gDAAhC,gCAAgC,QA4B3C"}

package/dist/domain.objects/Reviewer/ReviewerReflectMetrics.d.ts

@@ -0,0 +1,89 @@
+import { DomainLiteral } from 'domain-objects';
+/**
+ * .what = token usage and cost metrics for a reviewer reflect step
+ * .why = enables cost track and context window management
+ */
+export interface ReviewerReflectTokenMetrics {
+    /**
+     * input tokens sent to model
+     */
+    input: number;
+    /**
+     * tokens written to cache
+     */
+    cacheWrite: number;
+    /**
+     * tokens read from cache
+     */
+    cacheRead: number;
+    /**
+     * output tokens from model
+     */
+    output: number;
+}
+/**
+ * .what = cost breakdown by token type for reviewer reflect
+ * .why = enables cost analysis and optimization
+ */
+export interface ReviewerReflectCostMetrics {
+    /**
+     * cost for input tokens
+     */
+    input: number;
+    /**
+     * cost for cache write
+     */
+    cacheWrite: number;
+    /**
+     * cost for cache read
+     */
+    cacheRead: number;
+    /**
+     * cost for output tokens
+     */
+    output: number;
+    /**
+     * total cost
+     */
+    total: number;
+}
+/**
+ * .what = complete metrics for reviewer reflect skill execution
+ * .why = enables resource usage track across both steps
+ */
+export interface ReviewerReflectMetrics {
+    /**
+     * file counts
+     */
+    files: {
+        feedbackCount: number;
+        rulesCount: number;
+    };
+    /**
+     * pre-invocation estimates
+     */
+    expected: {
+        tokens: number;
+        contextWindowPercent: number;
+        cost: number;
+    };
+    /**
+     * actual usage after completion
+     */
+    realized: {
+        step1: {
+            tokens: ReviewerReflectTokenMetrics;
+            cost: ReviewerReflectCostMetrics;
+        };
+        step2: {
+            tokens: ReviewerReflectTokenMetrics;
+            cost: ReviewerReflectCostMetrics;
+        };
+        total: {
+            tokens: ReviewerReflectTokenMetrics;
+            cost: ReviewerReflectCostMetrics;
+        };
+    };
+}
+export declare class ReviewerReflectMetrics extends DomainLiteral<ReviewerReflectMetrics> implements ReviewerReflectMetrics {
+}

package/dist/domain.objects/Reviewer/ReviewerReflectMetrics.js

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

package/dist/domain.objects/Reviewer/ReviewerReflectMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReviewerReflectMetrics.js","sourceRoot":"","sources":["../../../src/domain.objects/Reviewer/ReviewerReflectMetrics.ts"],"names":[],"mappings":";;;AAAA,mDAA+C;AAoG/C,MAAa,sBACX,SAAQ,8BAAqC;CACT;AAFtC,wDAEsC"}

package/dist/domain.objects/Reviewer/ReviewerReflectRuleProposal.d.ts

@@ -0,0 +1,43 @@
+import { DomainLiteral } from 'domain-objects';
+/**
+ * .what = citation linking rule to origin feedback
+ * .why = enables provenance track for each rule
+ */
+export interface ReviewerReflectRuleCitation {
+    /**
+     * exact quote from feedback
+     */
+    quote: string;
+    /**
+     * github url to feedback file
+     */
+    url: string;
+}
+/**
+ * .what = proposed rule extracted from feedback
+ * .why = represents a generalized insight before blend
+ */
+export interface ReviewerReflectRuleProposal {
+    /**
+     * file path in pure/ directory
+     */
+    path: string;
+    /**
+     * directive: forbid, avoid, prefer, require
+     */
+    directive: 'forbid' | 'avoid' | 'prefer' | 'require';
+    /**
+     * topic in kebab-case
+     */
+    topic: string;
+    /**
+     * full markdown content of the rule
+     */
+    content: string;
+    /**
+     * citations to origin feedback
+     */
+    citations: ReviewerReflectRuleCitation[];
+}
+export declare class ReviewerReflectRuleProposal extends DomainLiteral<ReviewerReflectRuleProposal> implements ReviewerReflectRuleProposal {
+}

package/dist/domain.objects/Reviewer/ReviewerReflectRuleProposal.js

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

package/dist/domain.objects/Reviewer/ReviewerReflectRuleProposal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReviewerReflectRuleProposal.js","sourceRoot":"","sources":["../../../src/domain.objects/Reviewer/ReviewerReflectRuleProposal.ts"],"names":[],"mappings":";;;AAAA,mDAA+C;AAiD/C,MAAa,2BACX,SAAQ,8BAA0C;CACT;AAF3C,kEAE2C"}

package/dist/domain.operations/artifact/genLoopFeedback.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.genLoopFeedback = void 0;
 const rhachet_1 = require("rhachet");
-const genStepGrabCallerFeedbackToArtifact_1 = require("./genStepGrabCallerFeedbackToArtifact");
+const genStepGrabCallerFeedbackToArtifact_1 = require("../../domain.operations/artifact/genStepGrabCallerFeedbackToArtifact");
 const genLoopFeedback = ({ stitchee, artee, repeatee, halter, }) => {
     const stepGetFeedback = (0, genStepGrabCallerFeedbackToArtifact_1.genStepGrabCallerFeedbackToArtifact)({
         stitchee,

package/dist/domain.operations/artifact/genLoopFeedback.js.map

@@ -1 +1 @@
-{"version":3,"file":"genLoopFeedback.js","sourceRoot":"","sources":["../../../src/domain.operations/artifact/genLoopFeedback.ts"],"names":[],"mappings":";;;AAAA,qCAaiB;AAIjB,+FAA4F;AAErF,MAAM,eAAe,GAAG,CAM7B,EACA,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,MAAM,GAMP,EAuBC,EAAE;IACF,MAAM,eAAe,GAAG,IAAA,yEAAmC,EAIzD;QACA,QAAQ;QACR,KAAK;KACN,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAA,wBAAc,EAC1B,IAAA,wBAAc,EAAC;QACb,IAAI,EAAE,IAAI,QAAQ,2CAA2C;QAC7D,MAAM,EAAE,KAAK,QAAQ,mDAAmD;QACxE,QAAQ,EAAE,CAAC,QAAe,EAAE,IAAA,oBAAU,EAAC,eAAe,CAAC,CAAC;KACzD,CAAQ,CACV,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,2BAAiB,CAMtC;QACA,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,+BAA+B;QACrC,QAAQ,EAAE,QAAiB;QAC3B,MAAM,EAAE,+BAA+B;QACvC,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,MAEtB,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;YAC/D,OAAO;gBACL,KAAK,EAAE,EAAE,QAAQ,EAAE;gBACnB,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE;aACpD,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAA,oBAAU,EACtB,IAAA,wBAAc,EAAC;QACb,IAAI,EAAE,GAAG,QAAQ,CAAC,IAAI,mBAAmB;QACzC,MAAM,EAAE,IAAI,QAAQ,CAAC,IAAI,gEAAgE;QACzF,QAAQ,EAAE,IAAA,oBAAU,EAAC,KAAK,CAAC;QAC3B,OAAO,EAAE,IAAA,oBAAU,EAAC,UAAU,CAAC;QAC/B,MAAM;KACP,CAAC,CACH,CAAC;IAEF,OAAO,KAAY,CAAC;AACtB,CAAC,CAAC;AA3FW,QAAA,eAAe,mBA2F1B"}
+{"version":3,"file":"genLoopFeedback.js","sourceRoot":"","sources":["../../../src/domain.operations/artifact/genLoopFeedback.ts"],"names":[],"mappings":";;;AAAA,qCAaiB;AAIjB,6HAA0H;AAEnH,MAAM,eAAe,GAAG,CAM7B,EACA,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,MAAM,GAMP,EAuBC,EAAE;IACF,MAAM,eAAe,GAAG,IAAA,yEAAmC,EAIzD;QACA,QAAQ;QACR,KAAK;KACN,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAA,wBAAc,EAC1B,IAAA,wBAAc,EAAC;QACb,IAAI,EAAE,IAAI,QAAQ,2CAA2C;QAC7D,MAAM,EAAE,KAAK,QAAQ,mDAAmD;QACxE,QAAQ,EAAE,CAAC,QAAe,EAAE,IAAA,oBAAU,EAAC,eAAe,CAAC,CAAC;KACzD,CAAQ,CACV,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,2BAAiB,CAMtC;QACA,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,+BAA+B;QACrC,QAAQ,EAAE,QAAiB;QAC3B,MAAM,EAAE,+BAA+B;QACvC,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,MAEtB,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;YAC/D,OAAO;gBACL,KAAK,EAAE,EAAE,QAAQ,EAAE;gBACnB,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE;aACpD,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAA,oBAAU,EACtB,IAAA,wBAAc,EAAC;QACb,IAAI,EAAE,GAAG,QAAQ,CAAC,IAAI,mBAAmB;QACzC,MAAM,EAAE,IAAI,QAAQ,CAAC,IAAI,gEAAgE;QACzF,QAAQ,EAAE,IAAA,oBAAU,EAAC,KAAK,CAAC;QAC3B,OAAO,EAAE,IAAA,oBAAU,EAAC,UAAU,CAAC;QAC/B,MAAM;KACP,CAAC,CACH,CAAC;IAEF,OAAO,KAAY,CAAC;AACtB,CAAC,CAAC;AA3FW,QAAA,eAAe,mBA2F1B"}

package/dist/domain.operations/artifact/genStepGrabCallerFeedbackToArtifact.d.ts

@@ -5,7 +5,7 @@ import type { GitFile } from 'rhachet-artifact-git';
  * .what = creates a compute step where the static 'caller' gives feedback on another role's artifact
  * .why  = enables human review or annotation flow to be dynamically targeted, but statically sourced
  */
-export declare const genStepGrabCallerFeedbackToArtifact: <TStitchee extends string, TArtee extends string, TThreads extends Threads<{ [K in TStitchee | "caller"]: RoleContext<K, K extends "caller" ? {
+export declare const genStepGrabCallerFeedbackToArtifact: <TStitchee extends string, TArtee extends string, TThreads extends Threads<{ [K in "caller" | TStitchee]: RoleContext<K, K extends "caller" ? {
     art: {
         feedback: Artifact<typeof GitFile>;
     };

package/dist/domain.operations/brain.replic.arch1/core/invokeBrainArch1.d.ts

@@ -0,0 +1,13 @@
+import type { BrainArch1Actor } from '../../../domain.objects/BrainArch1/BrainArch1Actor';
+import type { BrainArch1Context } from '../../../domain.objects/BrainArch1/BrainArch1Context';
+import { BrainArch1LoopResult } from '../../../domain.objects/BrainArch1/BrainArch1LoopResult';
+import { BrainArch1SessionMessage } from '../../../domain.objects/BrainArch1/BrainArch1SessionMessage';
+/**
+ * .what = invokes the brain with a user input and returns the response
+ * .why = provides simple entry point for using the agentic loop
+ */
+export declare const invokeBrainArch1: (input: {
+    actor: BrainArch1Actor;
+    userInput: string;
+    conversationHistory?: BrainArch1SessionMessage[];
+}, context: BrainArch1Context) => Promise<BrainArch1LoopResult>;