rhachet-roles-bhrain 0.2.0 → 0.5.1

package/dist/domain.operations/brain.replic.arch1/core/invokeBrainArch1.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invokeBrainArch1 = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const BrainArch1LoopResult_1 = require("../../../domain.objects/BrainArch1/BrainArch1LoopResult");
+const BrainArch1MemoryTokenUsage_1 = require("../../../domain.objects/BrainArch1/BrainArch1MemoryTokenUsage");
+const BrainArch1PermissionDecision_1 = require("../../../domain.objects/BrainArch1/BrainArch1PermissionDecision");
+const BrainArch1SessionMessage_1 = require("../../../domain.objects/BrainArch1/BrainArch1SessionMessage");
+const runBrainArch1Loop_1 = require("../../../domain.operations/brain.replic.arch1/loop/runBrainArch1Loop");
+const mergeBrainArch1Toolboxes_1 = require("../../../domain.operations/brain.replic.arch1/tool/mergeBrainArch1Toolboxes");
+/**
+ * .what = default system prompt when none provided
+ * .why = establishes baseline assistant behavior
+ */
+const DEFAULT_SYSTEM_PROMPT = `You are a helpful assistant with access to tools.
+Use the tools when needed to help answer questions and complete tasks.
+Be concise and accurate in your responses.`;
+/**
+ * .what = default permission guard that allows all operations
+ * .why = provides sensible default when no guard specified
+ */
+const createDefaultPermissionGuard = () => ({
+    name: 'allowAll',
+    description: 'allows all tool operations',
+    check: async () => new BrainArch1PermissionDecision_1.BrainArch1PermissionDecision({ verdict: 'allow', reason: null }),
+});
+/**
+ * .what = invokes the brain with a user input and returns the response
+ * .why = provides simple entry point for using the agentic loop
+ */
+const invokeBrainArch1 = async (input, context) => {
+    // validate input
+    if (!input.userInput.trim()) {
+        return new BrainArch1LoopResult_1.BrainArch1LoopResult({
+            terminationReason: 'NATURAL_COMPLETION',
+            finalResponse: 'I notice your input was empty. Could you please provide a question or task?',
+            finalMessage: new BrainArch1SessionMessage_1.BrainArch1SessionMessage({
+                role: 'assistant',
+                content: 'I notice your input was empty. Could you please provide a question or task?',
+                toolCalls: null,
+                toolCallId: null,
+            }),
+            messages: [],
+            iterations: [],
+            iterationCount: 0,
+            totalTokenUsage: new BrainArch1MemoryTokenUsage_1.BrainArch1MemoryTokenUsage({
+                inputTokens: 0,
+                outputTokens: 0,
+                totalTokens: 0,
+                cacheReadTokens: null,
+                cacheWriteTokens: null,
+            }),
+            error: null,
+        });
+    }
+    // merge toolboxes
+    const { definitions, toolboxByToolName } = (0, mergeBrainArch1Toolboxes_1.mergeBrainArch1Toolboxes)({
+        toolboxes: input.actor.toolboxes,
+    });
+    // build initial messages
+    const systemPrompt = input.actor.role.systemPrompt ?? DEFAULT_SYSTEM_PROMPT;
+    const systemMessage = new BrainArch1SessionMessage_1.BrainArch1SessionMessage({
+        role: 'system',
+        content: systemPrompt,
+        toolCalls: null,
+        toolCallId: null,
+    });
+    const userMessage = new BrainArch1SessionMessage_1.BrainArch1SessionMessage({
+        role: 'user',
+        content: input.userInput,
+        toolCalls: null,
+        toolCallId: null,
+    });
+    const messages = [
+        systemMessage,
+        ...(input.conversationHistory ?? []),
+        userMessage,
+    ];
+    // estimate input token count (rough approximation)
+    const estimatedInputTokens = messages.reduce((acc, msg) => {
+        const content = msg.content ?? '';
+        return acc + Math.ceil(content.length / 4); // ~4 chars per token
+    }, 0);
+    // check if input exceeds max tokens
+    if (estimatedInputTokens > input.actor.constraints.maxTokens) {
+        throw new helpful_errors_1.BadRequestError('input exceeds context window limit', {
+            estimatedInputTokens,
+            maxTokens: input.actor.constraints.maxTokens,
+        });
+    }
+    // get permission guard
+    const permissionGuard = input.actor.permission ?? createDefaultPermissionGuard();
+    // run the agentic loop
+    const result = await (0, runBrainArch1Loop_1.runBrainArch1Loop)({
+        atom: input.actor.atom,
+        messages,
+        definitions,
+        toolboxByToolName,
+        permissionGuard,
+        maxIterations: input.actor.constraints.maxIterations,
+        maxTokens: input.actor.constraints.maxTokens,
+    }, context);
+    return result;
+};
+exports.invokeBrainArch1 = invokeBrainArch1;
+//# sourceMappingURL=invokeBrainArch1.js.map

package/dist/domain.operations/brain.replic.arch1/core/invokeBrainArch1.js.map

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

package/dist/domain.operations/brain.replic.arch1/llm/generateBrainArch1LlmResponse.d.ts

@@ -0,0 +1,18 @@
+import type { BrainArch1Atom } from '../../../domain.objects/BrainArch1/BrainArch1Atom';
+import type { BrainArch1Context } from '../../../domain.objects/BrainArch1/BrainArch1Context';
+import type { BrainArch1MemoryTokenUsage } from '../../../domain.objects/BrainArch1/BrainArch1MemoryTokenUsage';
+import type { BrainArch1SessionMessage } from '../../../domain.objects/BrainArch1/BrainArch1SessionMessage';
+import type { BrainArch1ToolDefinition } from '../../../domain.objects/BrainArch1/BrainArch1ToolDefinition';
+/**
+ * .what = generates an llm response using the provided atom plugin
+ * .why = delegates to atom.generate(), enabling brain to work with any atom implementation
+ */
+export declare const generateBrainArch1LlmResponse: (input: {
+    atom: BrainArch1Atom;
+    messages: BrainArch1SessionMessage[];
+    tools: BrainArch1ToolDefinition[];
+    maxTokens?: number;
+}, context: BrainArch1Context) => Promise<{
+    message: BrainArch1SessionMessage;
+    tokenUsage: BrainArch1MemoryTokenUsage;
+}>;

package/dist/domain.operations/brain.replic.arch1/llm/generateBrainArch1LlmResponse.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateBrainArch1LlmResponse = void 0;
+/**
+ * .what = generates an llm response using the provided atom plugin
+ * .why = delegates to atom.generate(), enabling brain to work with any atom implementation
+ */
+const generateBrainArch1LlmResponse = async (input, context) => {
+    return input.atom.generate({
+        messages: input.messages,
+        tools: input.tools,
+        maxTokens: input.maxTokens,
+    }, context);
+};
+exports.generateBrainArch1LlmResponse = generateBrainArch1LlmResponse;
+//# sourceMappingURL=generateBrainArch1LlmResponse.js.map

package/dist/domain.operations/brain.replic.arch1/llm/generateBrainArch1LlmResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateBrainArch1LlmResponse.js","sourceRoot":"","sources":["../../../../src/domain.operations/brain.replic.arch1/llm/generateBrainArch1LlmResponse.ts"],"names":[],"mappings":";;;AAMA;;;GAGG;AACI,MAAM,6BAA6B,GAAG,KAAK,EAChD,KAKC,EACD,OAA0B,EAIzB,EAAE;IACH,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CACxB;QACE,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,EACD,OAAO,CACR,CAAC;AACJ,CAAC,CAAC;AApBW,QAAA,6BAA6B,iCAoBxC"}

package/dist/domain.operations/brain.replic.arch1/loop/iterateBrainArch1Loop.d.ts

@@ -0,0 +1,30 @@
+import type { BrainArch1Atom } from '../../../domain.objects/BrainArch1/BrainArch1Atom';
+import type { BrainArch1Context } from '../../../domain.objects/BrainArch1/BrainArch1Context';
+import { BrainArch1LoopIteration } from '../../../domain.objects/BrainArch1/BrainArch1LoopIteration';
+import type { BrainArch1PermissionGuard } from '../../../domain.objects/BrainArch1/BrainArch1PermissionGuard';
+import { BrainArch1SessionMessage } from '../../../domain.objects/BrainArch1/BrainArch1SessionMessage';
+import type { BrainArch1Toolbox } from '../../../domain.objects/BrainArch1/BrainArch1Toolbox';
+import type { BrainArch1ToolDefinition } from '../../../domain.objects/BrainArch1/BrainArch1ToolDefinition';
+/**
+ * .what = result of a single loop iteration
+ * .why = provides updated messages and iteration metadata
+ */
+export interface IterateBrainArch1LoopResult {
+    messages: BrainArch1SessionMessage[];
+    iteration: BrainArch1LoopIteration;
+}
+/**
+ * .what = performs a single iteration of the brain loop
+ * .why = encapsulates generate → tools → append cycle
+ *
+ * .note = returns updated messages array with assistant response and tool results
+ */
+export declare const iterateBrainArch1Loop: (input: {
+    atom: BrainArch1Atom;
+    messages: BrainArch1SessionMessage[];
+    definitions: BrainArch1ToolDefinition[];
+    toolboxByToolName: Map<string, BrainArch1Toolbox>;
+    permissionGuard: BrainArch1PermissionGuard;
+    iterationNumber: number;
+    maxTokens?: number;
+}, context: BrainArch1Context) => Promise<IterateBrainArch1LoopResult>;

package/dist/domain.operations/brain.replic.arch1/loop/iterateBrainArch1Loop.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.iterateBrainArch1Loop = void 0;
+const BrainArch1LoopIteration_1 = require("../../../domain.objects/BrainArch1/BrainArch1LoopIteration");
+const BrainArch1SessionMessage_1 = require("../../../domain.objects/BrainArch1/BrainArch1SessionMessage");
+const generateBrainArch1LlmResponse_1 = require("../../../domain.operations/brain.replic.arch1/llm/generateBrainArch1LlmResponse");
+const executeBrainArch1ToolCall_1 = require("../../../domain.operations/brain.replic.arch1/tool/executeBrainArch1ToolCall");
+/**
+ * .what = performs a single iteration of the brain loop
+ * .why = encapsulates generate → tools → append cycle
+ *
+ * .note = returns updated messages array with assistant response and tool results
+ */
+const iterateBrainArch1Loop = async (input, context) => {
+    const startedAt = new Date().toISOString();
+    // generate llm response
+    const { message, tokenUsage } = await (0, generateBrainArch1LlmResponse_1.generateBrainArch1LlmResponse)({
+        atom: input.atom,
+        messages: input.messages,
+        tools: input.definitions,
+        maxTokens: input.maxTokens,
+    }, context);
+    // append assistant message to context
+    const messagesWithAssistant = [...input.messages, message];
+    // check for tool calls
+    const toolCalls = message.toolCalls ?? [];
+    const hadToolCalls = toolCalls.length > 0;
+    // if no tool calls, return early
+    if (!hadToolCalls) {
+        const completedAt = new Date().toISOString();
+        return {
+            messages: messagesWithAssistant,
+            iteration: new BrainArch1LoopIteration_1.BrainArch1LoopIteration({
+                iterationNumber: input.iterationNumber,
+                hadToolCalls: false,
+                toolCallCount: 0,
+                tokenUsage,
+                startedAt,
+                completedAt,
+            }),
+        };
+    }
+    // execute all tool calls
+    const toolResults = await Promise.all(toolCalls.map((call) => (0, executeBrainArch1ToolCall_1.executeBrainArch1ToolCall)({
+        call,
+        toolboxByToolName: input.toolboxByToolName,
+        permissionGuard: input.permissionGuard,
+    }, context)));
+    // append tool results as tool messages
+    const toolMessages = toolResults.map((result) => new BrainArch1SessionMessage_1.BrainArch1SessionMessage({
+        role: 'tool',
+        content: result.output,
+        toolCalls: null,
+        toolCallId: result.callId,
+    }));
+    const messagesWithToolResults = [...messagesWithAssistant, ...toolMessages];
+    const completedAt = new Date().toISOString();
+    return {
+        messages: messagesWithToolResults,
+        iteration: new BrainArch1LoopIteration_1.BrainArch1LoopIteration({
+            iterationNumber: input.iterationNumber,
+            hadToolCalls: true,
+            toolCallCount: toolCalls.length,
+            tokenUsage,
+            startedAt,
+            completedAt,
+        }),
+    };
+};
+exports.iterateBrainArch1Loop = iterateBrainArch1Loop;
+//# sourceMappingURL=iterateBrainArch1Loop.js.map

package/dist/domain.operations/brain.replic.arch1/loop/iterateBrainArch1Loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterateBrainArch1Loop.js","sourceRoot":"","sources":["../../../../src/domain.operations/brain.replic.arch1/loop/iterateBrainArch1Loop.ts"],"names":[],"mappings":";;;AAEA,oGAAiG;AAEjG,sGAAmG;AAGnG,+HAA4H;AAC5H,wHAAqH;AAWrH;;;;;GAKG;AACI,MAAM,qBAAqB,GAAG,KAAK,EACxC,KAQC,EACD,OAA0B,EACY,EAAE;IACxC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3C,wBAAwB;IACxB,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,IAAA,6DAA6B,EACjE;QACE,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,WAAW;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,EACD,OAAO,CACR,CAAC;IAEF,sCAAsC;IACtC,MAAM,qBAAqB,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE3D,uBAAuB;IACvB,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IAC1C,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAE1C,iCAAiC;IACjC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC7C,OAAO;YACL,QAAQ,EAAE,qBAAqB;YAC/B,SAAS,EAAE,IAAI,iDAAuB,CAAC;gBACrC,eAAe,EAAE,KAAK,CAAC,eAAe;gBACtC,YAAY,EAAE,KAAK;gBACnB,aAAa,EAAE,CAAC;gBAChB,UAAU;gBACV,SAAS;gBACT,WAAW;aACZ,CAAC;SACH,CAAC;IACJ,CAAC;IAED,yBAAyB;IACzB,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CACnC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACrB,IAAA,qDAAyB,EACvB;QACE,IAAI;QACJ,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,eAAe,EAAE,KAAK,CAAC,eAAe;KACvC,EACD,OAAO,CACR,CACF,CACF,CAAC;IAEF,uCAAuC;IACvC,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,CAClC,CAAC,MAAM,EAAE,EAAE,CACT,IAAI,mDAAwB,CAAC;QAC3B,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,MAAM,CAAC,MAAM;QACtB,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,MAAM,CAAC,MAAM;KAC1B,CAAC,CACL,CAAC;IAEF,MAAM,uBAAuB,GAAG,CAAC,GAAG,qBAAqB,EAAE,GAAG,YAAY,CAAC,CAAC;IAE5E,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,OAAO;QACL,QAAQ,EAAE,uBAAuB;QACjC,SAAS,EAAE,IAAI,iDAAuB,CAAC;YACrC,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,YAAY,EAAE,IAAI;YAClB,aAAa,EAAE,SAAS,CAAC,MAAM;YAC/B,UAAU;YACV,SAAS;YACT,WAAW;SACZ,CAAC;KACH,CAAC;AACJ,CAAC,CAAC;AAvFW,QAAA,qBAAqB,yBAuFhC"}

package/dist/domain.operations/brain.replic.arch1/loop/runBrainArch1Loop.d.ts

@@ -0,0 +1,20 @@
+import type { BrainArch1Atom } from '../../../domain.objects/BrainArch1/BrainArch1Atom';
+import type { BrainArch1Context } from '../../../domain.objects/BrainArch1/BrainArch1Context';
+import { BrainArch1LoopResult } from '../../../domain.objects/BrainArch1/BrainArch1LoopResult';
+import type { BrainArch1PermissionGuard } from '../../../domain.objects/BrainArch1/BrainArch1PermissionGuard';
+import type { BrainArch1SessionMessage } from '../../../domain.objects/BrainArch1/BrainArch1SessionMessage';
+import type { BrainArch1Toolbox } from '../../../domain.objects/BrainArch1/BrainArch1Toolbox';
+import type { BrainArch1ToolDefinition } from '../../../domain.objects/BrainArch1/BrainArch1ToolDefinition';
+/**
+ * .what = runs the agentic loop until completion
+ * .why = orchestrates iterations until natural completion or max iterations
+ */
+export declare const runBrainArch1Loop: (input: {
+    atom: BrainArch1Atom;
+    messages: BrainArch1SessionMessage[];
+    definitions: BrainArch1ToolDefinition[];
+    toolboxByToolName: Map<string, BrainArch1Toolbox>;
+    permissionGuard: BrainArch1PermissionGuard;
+    maxIterations?: number;
+    maxTokens?: number;
+}, context: BrainArch1Context) => Promise<BrainArch1LoopResult>;

package/dist/domain.operations/brain.replic.arch1/loop/runBrainArch1Loop.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBrainArch1Loop = void 0;
+const BrainArch1LoopResult_1 = require("../../../domain.objects/BrainArch1/BrainArch1LoopResult");
+const BrainArch1MemoryTokenUsage_1 = require("../../../domain.objects/BrainArch1/BrainArch1MemoryTokenUsage");
+const iterateBrainArch1Loop_1 = require("../../../domain.operations/brain.replic.arch1/loop/iterateBrainArch1Loop");
+/**
+ * .what = default max iterations if not specified
+ * .why = prevents infinite loops
+ */
+const DEFAULT_MAX_ITERATIONS = 100;
+/**
+ * .what = aggregates token usage across multiple iterations
+ * .why = enables tracking cumulative cost/usage
+ */
+const aggregateTokenUsage = (iterations) => {
+    const totals = iterations.reduce((acc, iter) => ({
+        inputTokens: acc.inputTokens + iter.tokenUsage.inputTokens,
+        outputTokens: acc.outputTokens + iter.tokenUsage.outputTokens,
+        totalTokens: acc.totalTokens + iter.tokenUsage.totalTokens,
+        cacheReadTokens: (acc.cacheReadTokens ?? 0) + (iter.tokenUsage.cacheReadTokens ?? 0),
+        cacheWriteTokens: (acc.cacheWriteTokens ?? 0) + (iter.tokenUsage.cacheWriteTokens ?? 0),
+    }), {
+        inputTokens: 0,
+        outputTokens: 0,
+        totalTokens: 0,
+        cacheReadTokens: 0,
+        cacheWriteTokens: 0,
+    });
+    return new BrainArch1MemoryTokenUsage_1.BrainArch1MemoryTokenUsage({
+        inputTokens: totals.inputTokens,
+        outputTokens: totals.outputTokens,
+        totalTokens: totals.totalTokens,
+        cacheReadTokens: totals.cacheReadTokens || null,
+        cacheWriteTokens: totals.cacheWriteTokens || null,
+    });
+};
+/**
+ * .what = runs the agentic loop until completion
+ * .why = orchestrates iterations until natural completion or max iterations
+ */
+const runBrainArch1Loop = async (input, context) => {
+    const maxIterations = input.maxIterations ?? DEFAULT_MAX_ITERATIONS;
+    const iterations = [];
+    let messages = input.messages;
+    // run loop until no tool calls or max iterations
+    for (let i = 0; i < maxIterations; i++) {
+        // execute single iteration
+        const result = await (0, iterateBrainArch1Loop_1.iterateBrainArch1Loop)({
+            atom: input.atom,
+            messages,
+            definitions: input.definitions,
+            toolboxByToolName: input.toolboxByToolName,
+            permissionGuard: input.permissionGuard,
+            iterationNumber: i,
+            maxTokens: input.maxTokens,
+        }, context);
+        // track iteration
+        iterations.push(result.iteration);
+        messages = result.messages;
+        // check for natural completion (no tool calls)
+        if (!result.iteration.hadToolCalls) {
+            const lastMessage = messages[messages.length - 1];
+            return new BrainArch1LoopResult_1.BrainArch1LoopResult({
+                terminationReason: 'NATURAL_COMPLETION',
+                finalResponse: lastMessage?.content ?? null,
+                finalMessage: lastMessage ?? null,
+                messages,
+                iterations,
+                iterationCount: iterations.length,
+                totalTokenUsage: aggregateTokenUsage(iterations),
+                error: null,
+            });
+        }
+    }
+    // max iterations reached
+    const lastMessage = messages[messages.length - 1];
+    return new BrainArch1LoopResult_1.BrainArch1LoopResult({
+        terminationReason: 'MAX_ITERATIONS',
+        finalResponse: lastMessage?.content ?? null,
+        finalMessage: lastMessage ?? null,
+        messages,
+        iterations,
+        iterationCount: iterations.length,
+        totalTokenUsage: aggregateTokenUsage(iterations),
+        error: `loop terminated after ${maxIterations} iterations`,
+    });
+};
+exports.runBrainArch1Loop = runBrainArch1Loop;
+//# sourceMappingURL=runBrainArch1Loop.js.map

package/dist/domain.operations/brain.replic.arch1/loop/runBrainArch1Loop.js.map

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

package/dist/domain.operations/brain.replic.arch1/plugins/atoms/anthropic.d.ts

@@ -0,0 +1,8 @@
+import type { BrainArch1Atom } from '../../../../domain.objects/BrainArch1/BrainArch1Atom';
+/**
+ * .what = creates an anthropic atom plugin for BrainArch1
+ * .why = enables using anthropic models (claude) with the brain architecture
+ */
+export declare const genAtomAnthropic: (input: {
+    model: string;
+}) => BrainArch1Atom;

package/dist/domain.operations/brain.replic.arch1/plugins/atoms/anthropic.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genAtomAnthropic = void 0;
+const sdkAnthropic_1 = require("../../../../access/sdks/anthropic/sdkAnthropic");
+/**
+ * .what = creates an anthropic atom plugin for BrainArch1
+ * .why = enables using anthropic models (claude) with the brain architecture
+ */
+const genAtomAnthropic = (input) => ({
+    platform: 'anthropic',
+    model: input.model,
+    description: `anthropic ${input.model} atom for llm generation`,
+    generate: async (params, context) => {
+        return sdkAnthropic_1.sdkAnthropic.generate({
+            messages: params.messages,
+            tools: params.tools,
+            maxTokens: params.maxTokens,
+        }, {
+            anthropic: {
+                auth: {
+                    key: context.creds.anthropic.apiKey,
+                    url: context.creds.anthropic.url ?? undefined,
+                },
+                llm: { model: input.model },
+            },
+            log: context.log,
+        });
+    },
+});
+exports.genAtomAnthropic = genAtomAnthropic;
+//# sourceMappingURL=anthropic.js.map

package/dist/domain.operations/brain.replic.arch1/plugins/atoms/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../../../../src/domain.operations/brain.replic.arch1/plugins/atoms/anthropic.ts"],"names":[],"mappings":";;;AAAA,0EAAuE;AAGvE;;;GAGG;AACI,MAAM,gBAAgB,GAAG,CAAC,KAAwB,EAAkB,EAAE,CAAC,CAAC;IAC7E,QAAQ,EAAE,WAAW;IACrB,KAAK,EAAE,KAAK,CAAC,KAAK;IAClB,WAAW,EAAE,aAAa,KAAK,CAAC,KAAK,0BAA0B;IAC/D,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;QAClC,OAAO,2BAAY,CAAC,QAAQ,CAC1B;YACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,EACD;YACE,SAAS,EAAE;gBACT,IAAI,EAAE;oBACJ,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM;oBACnC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,IAAI,SAAS;iBAC9C;gBACD,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;aAC5B;YACD,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAvBU,QAAA,gBAAgB,oBAuB1B"}

package/dist/domain.operations/brain.replic.arch1/plugins/atoms/index.d.ts

@@ -0,0 +1,3 @@
+export { genAtomAnthropic } from './anthropic';
+export { genAtomOpenai } from './openai';
+export { genAtomQwen } from './qwen';

package/dist/domain.operations/brain.replic.arch1/plugins/atoms/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genAtomQwen = exports.genAtomOpenai = exports.genAtomAnthropic = void 0;
+var anthropic_1 = require("./anthropic");
+Object.defineProperty(exports, "genAtomAnthropic", { enumerable: true, get: function () { return anthropic_1.genAtomAnthropic; } });
+var openai_1 = require("./openai");
+Object.defineProperty(exports, "genAtomOpenai", { enumerable: true, get: function () { return openai_1.genAtomOpenai; } });
+var qwen_1 = require("./qwen");
+Object.defineProperty(exports, "genAtomQwen", { enumerable: true, get: function () { return qwen_1.genAtomQwen; } });
+//# sourceMappingURL=index.js.map

package/dist/domain.operations/brain.replic.arch1/plugins/atoms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/domain.operations/brain.replic.arch1/plugins/atoms/index.ts"],"names":[],"mappings":";;;AAAA,yCAA+C;AAAtC,6GAAA,gBAAgB,OAAA;AACzB,mCAAyC;AAAhC,uGAAA,aAAa,OAAA;AACtB,+BAAqC;AAA5B,mGAAA,WAAW,OAAA"}

package/dist/domain.operations/brain.replic.arch1/plugins/atoms/openai.d.ts

@@ -0,0 +1,8 @@
+import type { BrainArch1Atom } from '../../../../domain.objects/BrainArch1/BrainArch1Atom';
+/**
+ * .what = creates an openai atom plugin for BrainArch1
+ * .why = enables using openai models (gpt-4, etc) with the brain architecture
+ */
+export declare const genAtomOpenai: (input: {
+    model: string;
+}) => BrainArch1Atom;

package/dist/domain.operations/brain.replic.arch1/plugins/atoms/openai.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genAtomOpenai = void 0;
+const sdkOpenAi_1 = require("../../../../access/sdk/sdkOpenAi");
+/**
+ * .what = creates an openai atom plugin for BrainArch1
+ * .why = enables using openai models (gpt-4, etc) with the brain architecture
+ */
+const genAtomOpenai = (input) => ({
+    platform: 'openai',
+    model: input.model,
+    description: `openai ${input.model} atom for llm generation`,
+    generate: async (params, context) => {
+        return sdkOpenAi_1.sdkOpenAi.generate({
+            messages: params.messages,
+            tools: params.tools,
+            maxTokens: params.maxTokens,
+        }, {
+            openai: {
+                auth: {
+                    key: context.creds.openai.apiKey,
+                    url: context.creds.openai.url ?? undefined,
+                },
+                llm: { model: input.model },
+            },
+            log: context.log,
+        });
+    },
+});
+exports.genAtomOpenai = genAtomOpenai;
+//# sourceMappingURL=openai.js.map

package/dist/domain.operations/brain.replic.arch1/plugins/atoms/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../../../src/domain.operations/brain.replic.arch1/plugins/atoms/openai.ts"],"names":[],"mappings":";;;AAAA,yDAAsD;AAGtD;;;GAGG;AACI,MAAM,aAAa,GAAG,CAAC,KAAwB,EAAkB,EAAE,CAAC,CAAC;IAC1E,QAAQ,EAAE,QAAQ;IAClB,KAAK,EAAE,KAAK,CAAC,KAAK;IAClB,WAAW,EAAE,UAAU,KAAK,CAAC,KAAK,0BAA0B;IAC5D,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;QAClC,OAAO,qBAAS,CAAC,QAAQ,CACvB;YACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,EACD;YACE,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM;oBAChC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,SAAS;iBAC3C;gBACD,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;aAC5B;YACD,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAvBU,QAAA,aAAa,iBAuBvB"}

package/dist/domain.operations/brain.replic.arch1/plugins/atoms/qwen.d.ts

@@ -0,0 +1,8 @@
+import type { BrainArch1Atom } from '../../../../domain.objects/BrainArch1/BrainArch1Atom';
+/**
+ * .what = creates a qwen atom plugin for BrainArch1
+ * .why = enables using qwen models with the brain architecture
+ */
+export declare const genAtomQwen: (input: {
+    model: string;
+}) => BrainArch1Atom;

package/dist/domain.operations/brain.replic.arch1/plugins/atoms/qwen.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genAtomQwen = void 0;
+const sdkQwen_1 = require("../../../../access/sdks/qwen/sdkQwen");
+/**
+ * .what = creates a qwen atom plugin for BrainArch1
+ * .why = enables using qwen models with the brain architecture
+ */
+const genAtomQwen = (input) => ({
+    platform: 'qwen',
+    model: input.model,
+    description: `qwen ${input.model} atom for llm generation`,
+    generate: async (params, context) => {
+        return sdkQwen_1.sdkQwen.generate({
+            messages: params.messages,
+            tools: params.tools,
+            maxTokens: params.maxTokens,
+        }, {
+            qwen: {
+                auth: {
+                    key: context.creds.qwen.apiKey,
+                    url: context.creds.qwen.url ??
+                        'https://dashscope.aliyuncs.com/compatible-mode/v1',
+                },
+                llm: { model: input.model },
+            },
+            log: context.log,
+        });
+    },
+});
+exports.genAtomQwen = genAtomQwen;
+//# sourceMappingURL=qwen.js.map

package/dist/domain.operations/brain.replic.arch1/plugins/atoms/qwen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwen.js","sourceRoot":"","sources":["../../../../../src/domain.operations/brain.replic.arch1/plugins/atoms/qwen.ts"],"names":[],"mappings":";;;AAAA,2DAAwD;AAGxD;;;GAGG;AACI,MAAM,WAAW,GAAG,CAAC,KAAwB,EAAkB,EAAE,CAAC,CAAC;IACxE,QAAQ,EAAE,MAAM;IAChB,KAAK,EAAE,KAAK,CAAC,KAAK;IAClB,WAAW,EAAE,QAAQ,KAAK,CAAC,KAAK,0BAA0B;IAC1D,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;QAClC,OAAO,iBAAO,CAAC,QAAQ,CACrB;YACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,EACD;YACE,IAAI,EAAE;gBACJ,IAAI,EAAE;oBACJ,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM;oBAC9B,GAAG,EACD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;wBACtB,mDAAmD;iBACtD;gBACD,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;aAC5B;YACD,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAzBU,QAAA,WAAW,eAyBrB"}

package/dist/domain.operations/brain.replic.arch1/plugins/memoryManagers/slidingWindow.d.ts

@@ -0,0 +1,6 @@
+import type { BrainArch1MemoryManager } from '../../../../domain.objects/BrainArch1/BrainArch1MemoryManager';
+/**
+ * .what = sliding window memory manager
+ * .why = simple strategy to keep context under limit by removing oldest messages
+ */
+export declare const memoryManagerSlidingWindow: BrainArch1MemoryManager;

package/dist/domain.operations/brain.replic.arch1/plugins/memoryManagers/slidingWindow.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memoryManagerSlidingWindow = void 0;
+const BrainArch1MemoryCompactionResult_1 = require("../../../../domain.objects/BrainArch1/BrainArch1MemoryCompactionResult");
+/**
+ * .what = estimates token count for a message
+ * .why = provides approximate token counting without external dependency
+ *
+ * .note = uses ~4 chars per token as rough estimate
+ */
+const estimateMessageTokens = (message) => {
+    const contentTokens = message.content
+        ? Math.ceil(message.content.length / 4)
+        : 0;
+    const toolCallsTokens = message.toolCalls
+        ? message.toolCalls.reduce((sum, tc) => {
+            const inputStr = JSON.stringify(tc.input);
+            return sum + Math.ceil((tc.name.length + inputStr.length) / 4);
+        }, 0)
+        : 0;
+    return contentTokens + toolCallsTokens + 10; // +10 for message overhead
+};
+/**
+ * .what = sliding window memory manager
+ * .why = simple strategy to keep context under limit by removing oldest messages
+ */
+exports.memoryManagerSlidingWindow = {
+    name: 'slidingWindow',
+    description: 'Removes oldest messages to keep context within token limits, preserving system message and recent context',
+    shouldCompact: async ({ currentTokens, maxTokens }) => {
+        // compact when we exceed 80% of max tokens
+        const threshold = maxTokens * 0.8;
+        return currentTokens > threshold;
+    },
+    compact: async ({ messages, currentTokens, targetTokens }) => {
+        // separate system message (always keep) from conversation
+        const systemMessages = messages.filter((m) => m.role === 'system');
+        const conversationMessages = messages.filter((m) => m.role !== 'system');
+        // calculate system message tokens
+        const systemTokens = systemMessages.reduce((sum, m) => sum + estimateMessageTokens(m), 0);
+        // keep removing oldest messages until under target
+        let compactedConversation = [...conversationMessages];
+        let conversationTokens = conversationMessages.reduce((sum, m) => sum + estimateMessageTokens(m), 0);
+        // remove messages from the beginning (oldest first)
+        while (systemTokens + conversationTokens > targetTokens &&
+            compactedConversation.length > 2 // keep at least last 2 messages
+        ) {
+            const removed = compactedConversation.shift();
+            if (removed) {
+                conversationTokens -= estimateMessageTokens(removed);
+            }
+        }
+        // if we removed assistant messages with tool calls, remove orphaned tool results
+        const validToolCallIds = new Set();
+        compactedConversation.forEach((m) => {
+            if (m.toolCalls) {
+                m.toolCalls.forEach((tc) => validToolCallIds.add(tc.id));
+            }
+        });
+        // filter out orphaned tool results
+        compactedConversation = compactedConversation.filter((m) => {
+            if (m.role === 'tool' && m.toolCallId) {
+                return validToolCallIds.has(m.toolCallId);
+            }
+            return true;
+        });
+        // recalculate tokens after orphan removal
+        conversationTokens = compactedConversation.reduce((sum, m) => sum + estimateMessageTokens(m), 0);
+        // combine system messages with compacted conversation
+        const compactedMessages = [...systemMessages, ...compactedConversation];
+        const tokensAfter = systemTokens + conversationTokens;
+        return new BrainArch1MemoryCompactionResult_1.BrainArch1MemoryCompactionResult({
+            messages: compactedMessages,
+            tokensBefore: currentTokens,
+            tokensAfter,
+            compactionTokenUsage: null, // no llm call needed for sliding window
+        });
+    },
+};
+//# sourceMappingURL=slidingWindow.js.map

package/dist/domain.operations/brain.replic.arch1/plugins/memoryManagers/slidingWindow.js.map

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