rhachet-roles-bhrain 0.2.0 → 0.5.1

package/dist/.test/getContextOpenAI.js

@@ -5,7 +5,7 @@ const helpful_errors_1 = require("helpful-errors");
 const getContextOpenAI = () => ({
     openai: {
         auth: {
-            key: process.env.PREP_OPENAI_KEY ??
+            key: process.env.OPENAI_API_KEY ??
                 helpful_errors_1.UnexpectedCodePathError.throw('prep openai key not declared in env'),
         },
         llm: {

package/dist/.test/getContextOpenAI.js.map

@@ -1 +1 @@
-{"version":3,"file":"getContextOpenAI.js","sourceRoot":"","sources":["../../src/.test/getContextOpenAI.ts"],"names":[],"mappings":";;;AAAA,mDAAyD;AAIlD,MAAM,gBAAgB,GAAG,GAAkB,EAAE,CAAC,CAAC;IACpD,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,GAAG,EACD,OAAO,CAAC,GAAG,CAAC,eAAe;gBAC3B,wCAAuB,CAAC,KAAK,CAAC,qCAAqC,CAAC;SACvE;QACD,GAAG,EAAE;YACH,mCAAmC;YACnC,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,OAAO;SAChB;KACF;CACF,CAAC,CAAC;AAbU,QAAA,gBAAgB,oBAa1B"}
+{"version":3,"file":"getContextOpenAI.js","sourceRoot":"","sources":["../../src/.test/getContextOpenAI.ts"],"names":[],"mappings":";;;AAAA,mDAAyD;AAIlD,MAAM,gBAAgB,GAAG,GAAkB,EAAE,CAAC,CAAC;IACpD,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,GAAG,EACD,OAAO,CAAC,GAAG,CAAC,cAAc;gBAC1B,wCAAuB,CAAC,KAAK,CAAC,qCAAqC,CAAC;SACvE;QACD,GAAG,EAAE;YACH,mCAAmC;YACnC,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,OAAO;SAChB;KACF;CACF,CAAC,CAAC;AAbU,QAAA,gBAAgB,oBAa1B"}

package/dist/access/sdk/sdkOpenAi.d.ts

@@ -1,9 +1,14 @@
 import type { ContextLogTrail } from 'as-procedure';
 import type { ChatModel } from 'openai/resources/index';
+import type { BrainArch1Context } from '../../domain.objects/BrainArch1/BrainArch1Context';
+import { BrainArch1MemoryTokenUsage } from '../../domain.objects/BrainArch1/BrainArch1MemoryTokenUsage';
+import { BrainArch1SessionMessage } from '../../domain.objects/BrainArch1/BrainArch1SessionMessage';
+import type { BrainArch1ToolDefinition } from '../../domain.objects/BrainArch1/BrainArch1ToolDefinition';
 export interface ContextOpenAI {
     openai: {
         auth: {
             key: string;
+            url?: string;
         };
         llm: {
             model: ChatModel;
@@ -13,4 +18,24 @@ export interface ContextOpenAI {
 }
 export declare const sdkOpenAi: {
     imagine: (input: string, context: ContextOpenAI & ContextLogTrail) => Promise<string>;
+    generate: (input: {
+        messages: BrainArch1SessionMessage[];
+        tools: BrainArch1ToolDefinition[];
+        maxTokens?: number;
+    }, context: {
+        openai: {
+            auth: {
+                key: string;
+                url?: string;
+            };
+            llm: {
+                model: string;
+            };
+        };
+    } & {
+        log: BrainArch1Context['log'];
+    }) => Promise<{
+        message: BrainArch1SessionMessage;
+        tokenUsage: BrainArch1MemoryTokenUsage;
+    }>;
 };

package/dist/access/sdk/sdkOpenAi.js

@@ -6,6 +6,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.sdkOpenAi = void 0;
 const helpful_errors_1 = require("helpful-errors");
 const openai_1 = __importDefault(require("openai"));
+const BrainArch1MemoryTokenUsage_1 = require("../../domain.objects/BrainArch1/BrainArch1MemoryTokenUsage");
+const BrainArch1SessionMessage_1 = require("../../domain.objects/BrainArch1/BrainArch1SessionMessage");
+const BrainArch1ToolCall_1 = require("../../domain.objects/BrainArch1/BrainArch1ToolCall");
 const imagine = async (input, context) => {
     const openai = new openai_1.default({
         apiKey: context.openai.auth.key,
@@ -36,7 +39,126 @@ const imagine = async (input, context) => {
         : content;
     return stripped;
 };
+/**
+ * .what = converts bhrain tool definitions to openai tool format
+ * .why = openai has its own function calling schema format
+ */
+const toOpenAiTools = (tools) => {
+    return tools.map((tool) => ({
+        type: 'function',
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: {
+                type: 'object',
+                properties: tool.schema.input.properties,
+                required: tool.schema.input.required,
+            },
+            strict: tool.strict,
+        },
+    }));
+};
+/**
+ * .what = converts bhrain messages to openai message format
+ * .why = openai has its own message structure
+ */
+const toOpenAiMessages = (messages) => {
+    return messages.map((msg) => {
+        // handle tool result messages
+        if (msg.role === 'tool' && msg.toolCallId) {
+            return {
+                role: 'tool',
+                tool_call_id: msg.toolCallId,
+                content: msg.content ?? '',
+            };
+        }
+        // handle assistant messages with tool calls
+        if (msg.role === 'assistant' && msg.toolCalls && msg.toolCalls.length > 0) {
+            return {
+                role: 'assistant',
+                content: msg.content,
+                tool_calls: msg.toolCalls.map((call) => ({
+                    id: call.id,
+                    type: 'function',
+                    function: {
+                        name: call.name,
+                        arguments: JSON.stringify(call.input),
+                    },
+                })),
+            };
+        }
+        // handle regular messages
+        if (msg.role === 'system') {
+            return { role: 'system', content: msg.content ?? '' };
+        }
+        if (msg.role === 'user') {
+            return { role: 'user', content: msg.content ?? '' };
+        }
+        return { role: 'assistant', content: msg.content ?? '' };
+    });
+};
+/**
+ * .what = converts openai response to bhrain message format
+ * .why = normalizes openai's response to our domain model
+ */
+const toBrainArch1Message = (choice) => {
+    const toolCalls = [];
+    if (choice.message.tool_calls) {
+        for (const tc of choice.message.tool_calls) {
+            toolCalls.push(new BrainArch1ToolCall_1.BrainArch1ToolCall({
+                id: tc.id,
+                name: tc.function.name,
+                input: JSON.parse(tc.function.arguments || '{}'),
+            }));
+        }
+    }
+    return new BrainArch1SessionMessage_1.BrainArch1SessionMessage({
+        role: 'assistant',
+        content: choice.message.content,
+        toolCalls: toolCalls.length > 0 ? toolCalls : null,
+        toolCallId: null,
+    });
+};
+/**
+ * .what = generates a response from openai api with tool support
+ * .why = enables brain to use openai as its llm atom
+ */
+const generate = async (input, context) => {
+    // instantiate client
+    const client = new openai_1.default({
+        apiKey: context.openai.auth.key,
+        baseURL: context.openai.auth.url,
+    });
+    // prepare request
+    const openaiMessages = toOpenAiMessages(input.messages);
+    const openaiTools = input.tools.length > 0 ? toOpenAiTools(input.tools) : undefined;
+    // make api call
+    const response = await client.chat.completions.create({
+        model: context.openai.llm.model,
+        max_tokens: input.maxTokens ?? 8192,
+        messages: openaiMessages,
+        tools: openaiTools,
+    });
+    // validate response
+    const choice = response.choices[0];
+    if (!choice) {
+        throw new helpful_errors_1.UnexpectedCodePathError('no choice in openai response', {
+            response,
+        });
+    }
+    // convert to bhrain format
+    const message = toBrainArch1Message(choice);
+    const tokenUsage = new BrainArch1MemoryTokenUsage_1.BrainArch1MemoryTokenUsage({
+        inputTokens: response.usage?.prompt_tokens ?? 0,
+        outputTokens: response.usage?.completion_tokens ?? 0,
+        totalTokens: response.usage?.total_tokens ?? 0,
+        cacheReadTokens: null,
+        cacheWriteTokens: null,
+    });
+    return { message, tokenUsage };
+};
 exports.sdkOpenAi = {
     imagine,
+    generate,
 };
 //# sourceMappingURL=sdkOpenAi.js.map

package/dist/access/sdk/sdkOpenAi.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdkOpenAi.js","sourceRoot":"","sources":["../../../src/access/sdk/sdkOpenAi.ts"],"names":[],"mappings":";;;;;;AACA,mDAAyD;AACzD,oDAA4B;AAa5B,MAAM,OAAO,GAAG,KAAK,EACnB,KAAa,EACb,OAAwC,EACvB,EAAE;IACnB,MAAM,MAAM,GAAG,IAAI,gBAAM,CAAC;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG;KAChC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;QACpD,eAAe,EACb,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM;YAClC,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE;YACzB,CAAC,CAAC,SAAS;QACf,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,KAAK;aACf;SACF;QACD,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK;KAChC,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACtB,MAAM,IAAI,wCAAuB,CAC/B,iDAAiD,EACjD,EAAE,QAAQ,EAAE,CACb,CAAC;IACJ,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAC7B,MAAM,IAAI,wCAAuB,CAC/B,wCAAwC,EACxC,EAAE,QAAQ,EAAE,CACb,CAAC;IACJ,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO;QACtC,MAAM,IAAI,wCAAuB,CAAC,iCAAiC,EAAE;YACnE,QAAQ;SACT,CAAC,CAAC;IACL,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC3D,MAAM,QAAQ,GACZ,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,iEAAiE;QACpH,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;QACpD,CAAC,CAAC,OAAO,CAAC;IACd,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEW,QAAA,SAAS,GAAG;IACvB,OAAO;CACR,CAAC"}
+{"version":3,"file":"sdkOpenAi.js","sourceRoot":"","sources":["../../../src/access/sdk/sdkOpenAi.ts"],"names":[],"mappings":"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"}

package/dist/access/sdks/anthropic/sdkAnthropic.d.ts

@@ -0,0 +1,31 @@
+import type { BrainArch1Context } from '../../../domain.objects/BrainArch1/BrainArch1Context';
+import { BrainArch1MemoryTokenUsage } from '../../../domain.objects/BrainArch1/BrainArch1MemoryTokenUsage';
+import { BrainArch1SessionMessage } from '../../../domain.objects/BrainArch1/BrainArch1SessionMessage';
+import type { BrainArch1ToolDefinition } from '../../../domain.objects/BrainArch1/BrainArch1ToolDefinition';
+/**
+ * .what = context required for anthropic api calls
+ * .why = enables dependency injection of anthropic-specific config
+ */
+export interface ContextAnthropic {
+    anthropic: {
+        auth: {
+            key: string;
+            url?: string;
+        };
+        llm: {
+            model: string;
+        };
+    };
+}
+export declare const sdkAnthropic: {
+    generate: (input: {
+        messages: BrainArch1SessionMessage[];
+        tools: BrainArch1ToolDefinition[];
+        maxTokens?: number;
+    }, context: ContextAnthropic & {
+        log: BrainArch1Context['log'];
+    }) => Promise<{
+        message: BrainArch1SessionMessage;
+        tokenUsage: BrainArch1MemoryTokenUsage;
+    }>;
+};

package/dist/access/sdks/anthropic/sdkAnthropic.js

@@ -0,0 +1,151 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sdkAnthropic = void 0;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const helpful_errors_1 = require("helpful-errors");
+const BrainArch1MemoryTokenUsage_1 = require("../../../domain.objects/BrainArch1/BrainArch1MemoryTokenUsage");
+const BrainArch1SessionMessage_1 = require("../../../domain.objects/BrainArch1/BrainArch1SessionMessage");
+const BrainArch1ToolCall_1 = require("../../../domain.objects/BrainArch1/BrainArch1ToolCall");
+/**
+ * .what = converts bhrain tool definitions to anthropic tool format
+ * .why = anthropic has its own tool schema format
+ */
+const toAnthropicTools = (tools) => {
+    return tools.map((tool) => ({
+        name: tool.name,
+        description: tool.description,
+        input_schema: {
+            type: 'object',
+            properties: tool.schema.input.properties,
+            required: tool.schema.input.required,
+        },
+    }));
+};
+/**
+ * .what = converts bhrain messages to anthropic message format
+ * .why = anthropic has its own message structure with content blocks
+ */
+const toAnthropicMessages = (messages) => {
+    return messages
+        .filter((m) => m.role !== 'system') // system handled separately
+        .map((msg) => {
+        // handle tool result messages
+        if (msg.role === 'tool' && msg.toolCallId) {
+            return {
+                role: 'user',
+                content: [
+                    {
+                        type: 'tool_result',
+                        tool_use_id: msg.toolCallId,
+                        content: msg.content ?? '',
+                    },
+                ],
+            };
+        }
+        // handle assistant messages with tool calls
+        if (msg.role === 'assistant' &&
+            msg.toolCalls &&
+            msg.toolCalls.length > 0) {
+            const content = [];
+            if (msg.content) {
+                content.push({ type: 'text', text: msg.content });
+            }
+            for (const call of msg.toolCalls) {
+                content.push({
+                    type: 'tool_use',
+                    id: call.id,
+                    name: call.name,
+                    input: call.input,
+                });
+            }
+            return { role: 'assistant', content };
+        }
+        // handle regular messages
+        return {
+            role: msg.role === 'user' ? 'user' : 'assistant',
+            content: msg.content ?? '',
+        };
+    });
+};
+/**
+ * .what = extracts system prompt from messages
+ * .why = anthropic handles system prompt separately from messages
+ */
+const extractSystemPrompt = (messages) => {
+    const systemMsg = messages.find((m) => m.role === 'system');
+    return systemMsg?.content ?? undefined;
+};
+/**
+ * .what = converts anthropic response to bhrain message format
+ * .why = normalizes anthropic's response to our domain model
+ */
+const toBrainArch1Message = (response) => {
+    let textContent = null;
+    const toolCalls = [];
+    for (const block of response.content) {
+        if (block.type === 'text') {
+            textContent = block.text;
+        }
+        else if (block.type === 'tool_use') {
+            toolCalls.push(new BrainArch1ToolCall_1.BrainArch1ToolCall({
+                id: block.id,
+                name: block.name,
+                input: block.input,
+            }));
+        }
+    }
+    return new BrainArch1SessionMessage_1.BrainArch1SessionMessage({
+        role: 'assistant',
+        content: textContent,
+        toolCalls: toolCalls.length > 0 ? toolCalls : null,
+        toolCallId: null,
+    });
+};
+/**
+ * .what = generates a response from anthropic claude api
+ * .why = enables brain to use anthropic as its llm atom
+ */
+const generate = async (input, context) => {
+    // instantiate client
+    const client = new sdk_1.default({
+        apiKey: context.anthropic.auth.key,
+        baseURL: context.anthropic.auth.url,
+    });
+    // prepare request
+    const systemPrompt = extractSystemPrompt(input.messages);
+    const anthropicMessages = toAnthropicMessages(input.messages);
+    const anthropicTools = input.tools.length > 0 ? toAnthropicTools(input.tools) : undefined;
+    // make api call
+    const response = await client.messages.create({
+        model: context.anthropic.llm.model,
+        max_tokens: input.maxTokens ?? 8192,
+        system: systemPrompt,
+        messages: anthropicMessages,
+        tools: anthropicTools,
+    });
+    // validate response
+    if (response.content.length === 0) {
+        throw new helpful_errors_1.UnexpectedCodePathError('empty content in anthropic response', {
+            response,
+        });
+    }
+    // convert to bhrain format
+    const message = toBrainArch1Message(response);
+    const tokenUsage = new BrainArch1MemoryTokenUsage_1.BrainArch1MemoryTokenUsage({
+        inputTokens: response.usage.input_tokens,
+        outputTokens: response.usage.output_tokens,
+        totalTokens: response.usage.input_tokens + response.usage.output_tokens,
+        cacheReadTokens: response.usage
+            .cache_read_input_tokens ?? null,
+        cacheWriteTokens: response.usage
+            .cache_creation_input_tokens ?? null,
+    });
+    return { message, tokenUsage };
+};
+exports.sdkAnthropic = {
+    generate,
+};
+//# sourceMappingURL=sdkAnthropic.js.map

package/dist/access/sdks/anthropic/sdkAnthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdkAnthropic.js","sourceRoot":"","sources":["../../../../src/access/sdks/anthropic/sdkAnthropic.ts"],"names":[],"mappings":"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"}

package/dist/access/sdks/qwen/sdkQwen.d.ts

@@ -0,0 +1,31 @@
+import type { BrainArch1Context } from '../../../domain.objects/BrainArch1/BrainArch1Context';
+import { BrainArch1MemoryTokenUsage } from '../../../domain.objects/BrainArch1/BrainArch1MemoryTokenUsage';
+import { BrainArch1SessionMessage } from '../../../domain.objects/BrainArch1/BrainArch1SessionMessage';
+import type { BrainArch1ToolDefinition } from '../../../domain.objects/BrainArch1/BrainArch1ToolDefinition';
+/**
+ * .what = context required for qwen api calls
+ * .why = enables dependency injection of qwen-specific config
+ */
+export interface ContextQwen {
+    qwen: {
+        auth: {
+            key: string;
+            url: string;
+        };
+        llm: {
+            model: string;
+        };
+    };
+}
+export declare const sdkQwen: {
+    generate: (input: {
+        messages: BrainArch1SessionMessage[];
+        tools: BrainArch1ToolDefinition[];
+        maxTokens?: number;
+    }, context: ContextQwen & {
+        log: BrainArch1Context['log'];
+    }) => Promise<{
+        message: BrainArch1SessionMessage;
+        tokenUsage: BrainArch1MemoryTokenUsage;
+    }>;
+};

package/dist/access/sdks/qwen/sdkQwen.js

@@ -0,0 +1,134 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sdkQwen = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const openai_1 = __importDefault(require("openai"));
+const BrainArch1MemoryTokenUsage_1 = require("../../../domain.objects/BrainArch1/BrainArch1MemoryTokenUsage");
+const BrainArch1SessionMessage_1 = require("../../../domain.objects/BrainArch1/BrainArch1SessionMessage");
+const BrainArch1ToolCall_1 = require("../../../domain.objects/BrainArch1/BrainArch1ToolCall");
+/**
+ * .what = converts bhrain tool definitions to openai-compatible tool format
+ * .why = qwen uses openai-compatible api
+ */
+const toQwenTools = (tools) => {
+    return tools.map((tool) => ({
+        type: 'function',
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: {
+                type: 'object',
+                properties: tool.schema.input.properties,
+                required: tool.schema.input.required,
+            },
+        },
+    }));
+};
+/**
+ * .what = converts bhrain messages to openai-compatible message format
+ * .why = qwen uses openai-compatible api
+ */
+const toQwenMessages = (messages) => {
+    return messages.map((msg) => {
+        // handle tool result messages
+        if (msg.role === 'tool' && msg.toolCallId) {
+            return {
+                role: 'tool',
+                tool_call_id: msg.toolCallId,
+                content: msg.content ?? '',
+            };
+        }
+        // handle assistant messages with tool calls
+        if (msg.role === 'assistant' && msg.toolCalls && msg.toolCalls.length > 0) {
+            return {
+                role: 'assistant',
+                content: msg.content,
+                tool_calls: msg.toolCalls.map((call) => ({
+                    id: call.id,
+                    type: 'function',
+                    function: {
+                        name: call.name,
+                        arguments: JSON.stringify(call.input),
+                    },
+                })),
+            };
+        }
+        // handle regular messages
+        if (msg.role === 'system') {
+            return { role: 'system', content: msg.content ?? '' };
+        }
+        if (msg.role === 'user') {
+            return { role: 'user', content: msg.content ?? '' };
+        }
+        return { role: 'assistant', content: msg.content ?? '' };
+    });
+};
+/**
+ * .what = converts qwen response to bhrain message format
+ * .why = normalizes qwen's response to our domain model
+ */
+const toBrainArch1Message = (choice) => {
+    const toolCalls = [];
+    if (choice.message.tool_calls) {
+        for (const tc of choice.message.tool_calls) {
+            toolCalls.push(new BrainArch1ToolCall_1.BrainArch1ToolCall({
+                id: tc.id,
+                name: tc.function.name,
+                input: JSON.parse(tc.function.arguments || '{}'),
+            }));
+        }
+    }
+    return new BrainArch1SessionMessage_1.BrainArch1SessionMessage({
+        role: 'assistant',
+        content: choice.message.content,
+        toolCalls: toolCalls.length > 0 ? toolCalls : null,
+        toolCallId: null,
+    });
+};
+/**
+ * .what = generates a response from qwen api (openai-compatible)
+ * .why = enables brain to use qwen as its llm atom
+ *
+ * .note = qwen uses dashscope's openai-compatible endpoint
+ */
+const generate = async (input, context) => {
+    // instantiate client with qwen endpoint
+    const client = new openai_1.default({
+        apiKey: context.qwen.auth.key,
+        baseURL: context.qwen.auth.url,
+    });
+    // prepare request
+    const qwenMessages = toQwenMessages(input.messages);
+    const qwenTools = input.tools.length > 0 ? toQwenTools(input.tools) : undefined;
+    // make api call
+    const response = await client.chat.completions.create({
+        model: context.qwen.llm.model,
+        max_tokens: input.maxTokens ?? 8192,
+        messages: qwenMessages,
+        tools: qwenTools,
+    });
+    // validate response
+    const choice = response.choices[0];
+    if (!choice) {
+        throw new helpful_errors_1.UnexpectedCodePathError('no choice in qwen response', {
+            response,
+        });
+    }
+    // convert to bhrain format
+    const message = toBrainArch1Message(choice);
+    const tokenUsage = new BrainArch1MemoryTokenUsage_1.BrainArch1MemoryTokenUsage({
+        inputTokens: response.usage?.prompt_tokens ?? 0,
+        outputTokens: response.usage?.completion_tokens ?? 0,
+        totalTokens: response.usage?.total_tokens ?? 0,
+        cacheReadTokens: null,
+        cacheWriteTokens: null,
+    });
+    return { message, tokenUsage };
+};
+exports.sdkQwen = {
+    generate,
+};
+//# sourceMappingURL=sdkQwen.js.map

package/dist/access/sdks/qwen/sdkQwen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdkQwen.js","sourceRoot":"","sources":["../../../../src/access/sdks/qwen/sdkQwen.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,67 @@
+import { DomainLiteral } from 'domain-objects';
+import type { BrainArch1Atom } from './BrainArch1Atom';
+import type { BrainArch1MemoryManager } from './BrainArch1MemoryManager';
+import type { BrainArch1PermissionGuard } from './BrainArch1PermissionGuard';
+import type { BrainArch1Toolbox } from './BrainArch1Toolbox';
+/**
+ * .what = instantiates a specific actor which will use the BrainArch1 architecture
+ * .why = enables configuring an actor with plugins (atom, tools, memory, permissions)
+ *        that the brain loop will leverage to enable action
+ *
+ * .note = the difference between actor & agent is that agency is granted only after
+ *         a real user delegates responsibilities to the actor. so we can't say it's
+ *         an agent here yet (since it could be readonly with no delegated responsibilities).
+ *         but we know for sure it's an actor.
+ */
+export interface BrainArch1Actor {
+    /**
+     * the llm atom plugin to use for generation
+     *
+     * .todo = support an atom plugin that chooses which model to use based on
+     *         context, task complexity, cost optimization, etc. Today we only support
+     *         using one atom for the entire session.
+     */
+    atom: BrainArch1Atom;
+    /**
+     * the role this actor should take
+     *
+     * .todo = support rhachet roles more fundamentally
+     */
+    role: {
+        /**
+         * system prompt to prepend to conversation (null for default)
+         */
+        systemPrompt: string | null;
+    };
+    /**
+     * constraints on actor execution
+     */
+    constraints: {
+        /**
+         * maximum iterations before forced termination
+         */
+        maxIterations: number;
+        /**
+         * maximum tokens for context window
+         */
+        maxTokens: number;
+    };
+    /**
+     * toolboxes available to the actor
+     */
+    toolboxes: BrainArch1Toolbox[];
+    /**
+     * memory manager plugin for context optimization
+     */
+    memory: BrainArch1MemoryManager | null;
+    /**
+     * permission guard plugin for tool execution authorization
+     */
+    permission: BrainArch1PermissionGuard | null;
+}
+export declare class BrainArch1Actor extends DomainLiteral<BrainArch1Actor> implements BrainArch1Actor {
+    static nested: {
+        role: typeof DomainLiteral;
+        constraints: typeof DomainLiteral;
+    };
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"BrainArch1Actor.js","sourceRoot":"","sources":["../../../src/domain.objects/BrainArch1/BrainArch1Actor.ts"],"names":[],"mappings":";;;AAAA,mDAA+C;AAsE/C,MAAa,eACX,SAAQ,8BAA8B;;AADxC,0CAQC;AAJe,sBAAM,GAAG;IACrB,IAAI,EAAE,8BAAa;IACnB,WAAW,EAAE,8BAAa;CAC3B,CAAC"}