rhachet-roles-bhrain 0.3.0 → 0.5.2

package/dist/domain.operations/brain.replic.arch1/plugins/permissionGuards/allowAll.d.ts

@@ -0,0 +1,6 @@
+import type { BrainArch1PermissionGuard } from '../../../../domain.objects/BrainArch1/BrainArch1PermissionGuard';
+/**
+ * .what = permission guard that allows all tool calls
+ * .why = provides a default permissive policy for trusted environments
+ */
+export declare const permissionGuardAllowAll: BrainArch1PermissionGuard;

package/dist/domain.operations/brain.replic.arch1/plugins/permissionGuards/allowAll.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.permissionGuardAllowAll = void 0;
+const BrainArch1PermissionDecision_1 = require("../../../../domain.objects/BrainArch1/BrainArch1PermissionDecision");
+/**
+ * .what = permission guard that allows all tool calls
+ * .why = provides a default permissive policy for trusted environments
+ */
+exports.permissionGuardAllowAll = {
+    name: 'allowAll',
+    description: 'allows all tool operations without restriction',
+    check: async () => new BrainArch1PermissionDecision_1.BrainArch1PermissionDecision({ verdict: 'allow', reason: null }),
+};
+//# sourceMappingURL=allowAll.js.map

package/dist/domain.operations/brain.replic.arch1/plugins/permissionGuards/allowAll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowAll.js","sourceRoot":"","sources":["../../../../../src/domain.operations/brain.replic.arch1/plugins/permissionGuards/allowAll.ts"],"names":[],"mappings":";;;AAAA,8GAA2G;AAG3G;;;GAGG;AACU,QAAA,uBAAuB,GAA8B;IAChE,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,gDAAgD;IAC7D,KAAK,EAAE,KAAK,IAAI,EAAE,CAChB,IAAI,2DAA4B,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;CACvE,CAAC"}

package/dist/domain.operations/brain.replic.arch1/plugins/permissionGuards/promptUser.d.ts

@@ -0,0 +1,8 @@
+import type { BrainArch1PermissionGuard } from '../../../../domain.objects/BrainArch1/BrainArch1PermissionGuard';
+/**
+ * .what = permission guard that prompts user for sensitive operations
+ * .why = balances automation with user control for potentially destructive actions
+ *
+ * .note = allows read-only operations, prompts for writes/executions
+ */
+export declare const permissionGuardPromptUser: BrainArch1PermissionGuard;

package/dist/domain.operations/brain.replic.arch1/plugins/permissionGuards/promptUser.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.permissionGuardPromptUser = void 0;
+const BrainArch1PermissionDecision_1 = require("../../../../domain.objects/BrainArch1/BrainArch1PermissionDecision");
+/**
+ * .what = tools that require user approval before execution
+ * .why = provides sensible defaults for which operations need explicit consent
+ */
+const PROMPT_REQUIRED_TOOLS = new Set([
+    'bash_exec', // shell commands can be destructive
+    'files_write', // file creation can overwrite
+    'files_edit', // file modification can corrupt
+]);
+/**
+ * .what = tools that are always safe to execute
+ * .why = read-only operations don't need approval
+ */
+const ALWAYS_ALLOWED_TOOLS = new Set([
+    'files_read', // reading files is safe
+    'files_glob', // listing files is safe
+    'files_grep', // searching files is safe
+]);
+/**
+ * .what = permission guard that prompts user for sensitive operations
+ * .why = balances automation with user control for potentially destructive actions
+ *
+ * .note = allows read-only operations, prompts for writes/executions
+ */
+exports.permissionGuardPromptUser = {
+    name: 'promptUser',
+    description: 'prompts for user approval on write/execute operations, allows read-only operations',
+    check: async ({ call }) => {
+        // allow read-only tools immediately
+        if (ALWAYS_ALLOWED_TOOLS.has(call.name))
+            return new BrainArch1PermissionDecision_1.BrainArch1PermissionDecision({
+                verdict: 'allow',
+                reason: null,
+            });
+        // prompt for known sensitive tools
+        if (PROMPT_REQUIRED_TOOLS.has(call.name))
+            return new BrainArch1PermissionDecision_1.BrainArch1PermissionDecision({
+                verdict: 'prompt',
+                reason: `tool '${call.name}' requires user approval`,
+            });
+        // default to prompting for unknown tools (fail-safe)
+        return new BrainArch1PermissionDecision_1.BrainArch1PermissionDecision({
+            verdict: 'prompt',
+            reason: `unknown tool '${call.name}' requires user approval`,
+        });
+    },
+};
+//# sourceMappingURL=promptUser.js.map

package/dist/domain.operations/brain.replic.arch1/plugins/permissionGuards/promptUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptUser.js","sourceRoot":"","sources":["../../../../../src/domain.operations/brain.replic.arch1/plugins/permissionGuards/promptUser.ts"],"names":[],"mappings":";;;AAAA,8GAA2G;AAG3G;;;GAGG;AACH,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,WAAW,EAAE,oCAAoC;IACjD,aAAa,EAAE,8BAA8B;IAC7C,YAAY,EAAE,gCAAgC;CAC/C,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,YAAY,EAAE,wBAAwB;IACtC,YAAY,EAAE,wBAAwB;IACtC,YAAY,EAAE,0BAA0B;CACzC,CAAC,CAAC;AAEH;;;;;GAKG;AACU,QAAA,yBAAyB,GAA8B;IAClE,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,oFAAoF;IAEtF,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACxB,oCAAoC;QACpC,IAAI,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YACrC,OAAO,IAAI,2DAA4B,CAAC;gBACtC,OAAO,EAAE,OAAO;gBAChB,MAAM,EAAE,IAAI;aACb,CAAC,CAAC;QAEL,mCAAmC;QACnC,IAAI,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YACtC,OAAO,IAAI,2DAA4B,CAAC;gBACtC,OAAO,EAAE,QAAQ;gBACjB,MAAM,EAAE,SAAS,IAAI,CAAC,IAAI,0BAA0B;aACrD,CAAC,CAAC;QAEL,qDAAqD;QACrD,OAAO,IAAI,2DAA4B,CAAC;YACtC,OAAO,EAAE,QAAQ;YACjB,MAAM,EAAE,iBAAiB,IAAI,CAAC,IAAI,0BAA0B;SAC7D,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/domain.operations/brain.replic.arch1/plugins/permissionGuards/readOnly.d.ts

@@ -0,0 +1,8 @@
+import type { BrainArch1PermissionGuard } from '../../../../domain.objects/BrainArch1/BrainArch1PermissionGuard';
+/**
+ * .what = permission guard that allows read-only operations, prompts for all else
+ * .why = provides a safe default that enables exploration without risk of modification
+ *
+ * .note = this is the recommended default permission guard
+ */
+export declare const permissionGuardReadOnly: BrainArch1PermissionGuard;

package/dist/domain.operations/brain.replic.arch1/plugins/permissionGuards/readOnly.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.permissionGuardReadOnly = void 0;
+const BrainArch1PermissionDecision_1 = require("../../../../domain.objects/BrainArch1/BrainArch1PermissionDecision");
+/**
+ * .what = tools that are safe to execute without prompting
+ * .why = read-only operations don't modify state and are always safe
+ */
+const ALLOWED_TOOLS = new Set([
+    'files_read', // reading files is safe
+    'files_glob', // listing files is safe
+    'files_grep', // searching files is safe
+    'websearch', // searching the web is safe
+]);
+/**
+ * .what = permission guard that allows read-only operations, prompts for all else
+ * .why = provides a safe default that enables exploration without risk of modification
+ *
+ * .note = this is the recommended default permission guard
+ */
+exports.permissionGuardReadOnly = {
+    name: 'readOnly',
+    description: 'allows read-only operations (file reads, web searches), prompts for all else',
+    check: async ({ call }) => {
+        // allow read-only tools immediately
+        if (ALLOWED_TOOLS.has(call.name))
+            return new BrainArch1PermissionDecision_1.BrainArch1PermissionDecision({
+                verdict: 'allow',
+                reason: null,
+            });
+        // prompt for everything else
+        return new BrainArch1PermissionDecision_1.BrainArch1PermissionDecision({
+            verdict: 'prompt',
+            reason: `tool '${call.name}' requires user approval`,
+        });
+    },
+};
+//# sourceMappingURL=readOnly.js.map

package/dist/domain.operations/brain.replic.arch1/plugins/permissionGuards/readOnly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readOnly.js","sourceRoot":"","sources":["../../../../../src/domain.operations/brain.replic.arch1/plugins/permissionGuards/readOnly.ts"],"names":[],"mappings":";;;AAAA,8GAA2G;AAG3G;;;GAGG;AACH,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,YAAY,EAAE,wBAAwB;IACtC,YAAY,EAAE,wBAAwB;IACtC,YAAY,EAAE,0BAA0B;IACxC,WAAW,EAAE,4BAA4B;CAC1C,CAAC,CAAC;AAEH;;;;;GAKG;AACU,QAAA,uBAAuB,GAA8B;IAChE,IAAI,EAAE,UAAU;IAChB,WAAW,EACT,8EAA8E;IAEhF,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACxB,oCAAoC;QACpC,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9B,OAAO,IAAI,2DAA4B,CAAC;gBACtC,OAAO,EAAE,OAAO;gBAChB,MAAM,EAAE,IAAI;aACb,CAAC,CAAC;QAEL,6BAA6B;QAC7B,OAAO,IAAI,2DAA4B,CAAC;YACtC,OAAO,EAAE,QAAQ;YACjB,MAAM,EAAE,SAAS,IAAI,CAAC,IAAI,0BAA0B;SACrD,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/domain.operations/brain.replic.arch1/plugins/toolboxes/bash/exec.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import type { BrainArch1ToolCall } from '../../../../../domain.objects/BrainArch1/BrainArch1ToolCall';
+import { BrainArch1ToolDefinition } from '../../../../../domain.objects/BrainArch1/BrainArch1ToolDefinition';
+import { BrainArch1ToolResult } from '../../../../../domain.objects/BrainArch1/BrainArch1ToolResult';
+/**
+ * .what = zod schema for bash exec tool input
+ * .why = enables type-safe validation and json schema generation
+ */
+export declare const schemaExecInput: z.ZodObject<{
+    command: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    cwd?: string | undefined;
+    timeout?: number | undefined;
+}, {
+    command: string;
+    cwd?: string | undefined;
+    timeout?: number | undefined;
+}>;
+/**
+ * .what = tool definition for executing bash commands
+ * .why = enables agentic shell command execution
+ */
+export declare const toolDefinitionExec: BrainArch1ToolDefinition;
+/**
+ * .what = executes bash commands
+ * .why = enables shell operations for agentic workflows
+ */
+export declare const executeExec: (input: {
+    call: BrainArch1ToolCall;
+}) => Promise<BrainArch1ToolResult>;

package/dist/domain.operations/brain.replic.arch1/plugins/toolboxes/bash/exec.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeExec = exports.toolDefinitionExec = exports.schemaExecInput = void 0;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const zod_1 = require("zod");
+const BrainArch1ToolDefinition_1 = require("../../../../../domain.objects/BrainArch1/BrainArch1ToolDefinition");
+const BrainArch1ToolResult_1 = require("../../../../../domain.objects/BrainArch1/BrainArch1ToolResult");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+/**
+ * .what = zod schema for bash exec tool input
+ * .why = enables type-safe validation and json schema generation
+ */
+exports.schemaExecInput = zod_1.z.object({
+    command: zod_1.z.string().describe('The bash command to execute'),
+    cwd: zod_1.z
+        .string()
+        .optional()
+        .describe('Working directory for the command. Defaults to current directory.'),
+    timeout: zod_1.z
+        .number()
+        .optional()
+        .describe('Timeout in milliseconds. Defaults to 30000 (30 seconds).'),
+});
+/**
+ * .what = tool definition for executing bash commands
+ * .why = enables agentic shell command execution
+ */
+exports.toolDefinitionExec = new BrainArch1ToolDefinition_1.BrainArch1ToolDefinition({
+    name: 'bash_exec',
+    description: 'Executes a bash command and returns stdout/stderr. Use for git, npm, system commands, etc.',
+    schema: {
+        input: (0, BrainArch1ToolDefinition_1.toJsonSchema)(exports.schemaExecInput),
+    },
+    strict: false,
+});
+/**
+ * .what = executes bash commands
+ * .why = enables shell operations for agentic workflows
+ */
+const executeExec = async (input) => {
+    const args = input.call.input;
+    // validate command is provided
+    if (!args.command || typeof args.command !== 'string') {
+        return new BrainArch1ToolResult_1.BrainArch1ToolResult({
+            callId: input.call.id,
+            success: false,
+            output: '',
+            error: 'command is required and must be a string',
+        });
+    }
+    // execute the command
+    try {
+        const timeout = args.timeout ?? 30000;
+        const cwd = args.cwd ?? process.cwd();
+        const { stdout, stderr } = await execAsync(args.command, {
+            cwd,
+            timeout,
+            maxBuffer: 10 * 1024 * 1024, // 10MB buffer
+        });
+        // format output
+        const output = [
+            stdout ? `stdout:\n${stdout}` : null,
+            stderr ? `stderr:\n${stderr}` : null,
+        ]
+            .filter(Boolean)
+            .join('\n\n');
+        return new BrainArch1ToolResult_1.BrainArch1ToolResult({
+            callId: input.call.id,
+            success: true,
+            output: output || '(no output)',
+            error: null,
+        });
+    }
+    catch (error) {
+        // handle exec errors (non-zero exit, timeout, etc)
+        const execError = error;
+        const output = [
+            execError.stdout ? `stdout:\n${execError.stdout}` : null,
+            execError.stderr ? `stderr:\n${execError.stderr}` : null,
+        ]
+            .filter(Boolean)
+            .join('\n\n');
+        const errorMsg = [
+            execError.message ?? String(error),
+            execError.code !== undefined ? `exit code: ${execError.code}` : null,
+            execError.killed ? 'process was killed (timeout or signal)' : null,
+        ]
+            .filter(Boolean)
+            .join('; ');
+        return new BrainArch1ToolResult_1.BrainArch1ToolResult({
+            callId: input.call.id,
+            success: false,
+            output: output || '',
+            error: errorMsg,
+        });
+    }
+};
+exports.executeExec = executeExec;
+//# sourceMappingURL=exec.js.map

package/dist/domain.operations/brain.replic.arch1/plugins/toolboxes/bash/exec.js.map

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

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

@@ -0,0 +1,6 @@
+import type { BrainArch1Toolbox } from '../../../../../domain.objects/BrainArch1/BrainArch1Toolbox';
+/**
+ * .what = toolbox for bash command execution
+ * .why = enables agentic shell operations
+ */
+export declare const toolboxBash: BrainArch1Toolbox;

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

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolboxBash = void 0;
+const BrainArch1ToolResult_1 = require("../../../../../domain.objects/BrainArch1/BrainArch1ToolResult");
+const exec_1 = require("./exec");
+/**
+ * .what = toolbox for bash command execution
+ * .why = enables agentic shell operations
+ */
+exports.toolboxBash = {
+    name: 'bash',
+    definitions: [exec_1.toolDefinitionExec],
+    execute: async (input, _context) => {
+        // route to the correct executor
+        if (input.call.name === 'bash_exec')
+            return (0, exec_1.executeExec)(input);
+        // unknown tool
+        return new BrainArch1ToolResult_1.BrainArch1ToolResult({
+            callId: input.call.id,
+            success: false,
+            output: '',
+            error: `unknown bash tool '${input.call.name}'`,
+        });
+    },
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/domain.operations/brain.replic.arch1/plugins/toolboxes/bash/index.ts"],"names":[],"mappings":";;;AAGA,8FAA2F;AAE3F,iCAAyD;AAEzD;;;GAGG;AACU,QAAA,WAAW,GAAsB;IAC5C,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,CAAC,yBAAkB,CAAC;IACjC,OAAO,EAAE,KAAK,EACZ,KAAmC,EACnC,QAA2B,EAC3B,EAAE;QACF,gCAAgC;QAChC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO,IAAA,kBAAW,EAAC,KAAK,CAAC,CAAC;QAE/D,eAAe;QACf,OAAO,IAAI,2CAAoB,CAAC;YAC9B,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;YACrB,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,sBAAsB,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG;SAChD,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/domain.operations/brain.replic.arch1/plugins/toolboxes/files/edit.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { BrainArch1ToolDefinition } from '../../../../../domain.objects/BrainArch1/BrainArch1ToolDefinition';
+import { BrainArch1ToolResult } from '../../../../../domain.objects/BrainArch1/BrainArch1ToolResult';
+/**
+ * .what = zod schema for edit tool input
+ * .why = enables type-safe validation and json schema generation
+ */
+export declare const schemaEditInput: z.ZodObject<{
+    path: z.ZodString;
+    old_string: z.ZodString;
+    new_string: z.ZodString;
+    replace_all: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    old_string: string;
+    new_string: string;
+    replace_all?: boolean | undefined;
+}, {
+    path: string;
+    old_string: string;
+    new_string: string;
+    replace_all?: boolean | undefined;
+}>;
+/**
+ * .what = tool definition for editing file contents via string replacement
+ * .why = enables the brain to make precise changes to existing files
+ */
+export declare const toolDefinitionEdit: BrainArch1ToolDefinition;
+/**
+ * .what = executes the edit tool
+ * .why = performs the actual file edit operation
+ */
+export declare const executeToolEdit: (input: {
+    callId: string;
+    args: {
+        path: string;
+        old_string: string;
+        new_string: string;
+        replace_all?: boolean;
+    };
+}) => Promise<BrainArch1ToolResult>;

package/dist/domain.operations/brain.replic.arch1/plugins/toolboxes/files/edit.js

@@ -0,0 +1,107 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeToolEdit = exports.toolDefinitionEdit = exports.schemaEditInput = void 0;
+const fs = __importStar(require("fs/promises"));
+const zod_1 = require("zod");
+const BrainArch1ToolDefinition_1 = require("../../../../../domain.objects/BrainArch1/BrainArch1ToolDefinition");
+const BrainArch1ToolResult_1 = require("../../../../../domain.objects/BrainArch1/BrainArch1ToolResult");
+/**
+ * .what = zod schema for edit tool input
+ * .why = enables type-safe validation and json schema generation
+ */
+exports.schemaEditInput = zod_1.z.object({
+    path: zod_1.z.string().describe('The absolute path to the file to edit'),
+    old_string: zod_1.z.string().describe('The exact string to find and replace'),
+    new_string: zod_1.z.string().describe('The string to replace it with'),
+    replace_all: zod_1.z
+        .boolean()
+        .optional()
+        .describe('If true, replace all occurrences. Otherwise, fail if multiple matches.'),
+});
+/**
+ * .what = tool definition for editing file contents via string replacement
+ * .why = enables the brain to make precise changes to existing files
+ */
+exports.toolDefinitionEdit = new BrainArch1ToolDefinition_1.BrainArch1ToolDefinition({
+    name: 'edit',
+    description: 'Performs exact string replacement in a file. The old_string must be unique in the file unless replace_all is true.',
+    schema: {
+        input: (0, BrainArch1ToolDefinition_1.toJsonSchema)(exports.schemaEditInput),
+    },
+    strict: false,
+});
+/**
+ * .what = executes the edit tool
+ * .why = performs the actual file edit operation
+ */
+const executeToolEdit = async (input) => {
+    try {
+        // read current content
+        const content = await fs.readFile(input.args.path, 'utf-8');
+        // count occurrences
+        const occurrences = content.split(input.args.old_string).length - 1;
+        // validate uniqueness
+        if (occurrences === 0) {
+            return new BrainArch1ToolResult_1.BrainArch1ToolResult({
+                callId: input.callId,
+                success: false,
+                output: '',
+                error: 'old_string not found in file',
+            });
+        }
+        if (occurrences > 1 && !input.args.replace_all) {
+            return new BrainArch1ToolResult_1.BrainArch1ToolResult({
+                callId: input.callId,
+                success: false,
+                output: '',
+                error: `old_string found ${occurrences} times. use replace_all=true or provide more context.`,
+            });
+        }
+        // perform replacement
+        const newContent = input.args.replace_all
+            ? content.split(input.args.old_string).join(input.args.new_string)
+            : content.replace(input.args.old_string, input.args.new_string);
+        // write updated content
+        await fs.writeFile(input.args.path, newContent, 'utf-8');
+        return new BrainArch1ToolResult_1.BrainArch1ToolResult({
+            callId: input.callId,
+            success: true,
+            output: `replaced ${input.args.replace_all ? occurrences : 1} occurrence(s)`,
+            error: null,
+        });
+    }
+    catch (err) {
+        const error = err instanceof Error ? err.message : String(err);
+        return new BrainArch1ToolResult_1.BrainArch1ToolResult({
+            callId: input.callId,
+            success: false,
+            output: '',
+            error: `failed to edit file: ${error}`,
+        });
+    }
+};
+exports.executeToolEdit = executeToolEdit;
+//# sourceMappingURL=edit.js.map

package/dist/domain.operations/brain.replic.arch1/plugins/toolboxes/files/edit.js.map

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

package/dist/domain.operations/brain.replic.arch1/plugins/toolboxes/files/glob.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { BrainArch1ToolDefinition } from '../../../../../domain.objects/BrainArch1/BrainArch1ToolDefinition';
+import { BrainArch1ToolResult } from '../../../../../domain.objects/BrainArch1/BrainArch1ToolResult';
+/**
+ * .what = zod schema for glob tool input
+ * .why = enables type-safe validation and json schema generation
+ */
+export declare const schemaGlobInput: z.ZodObject<{
+    pattern: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    pattern: string;
+    cwd?: string | undefined;
+}, {
+    pattern: string;
+    cwd?: string | undefined;
+}>;
+/**
+ * .what = tool definition for finding files by glob pattern
+ * .why = enables the brain to discover files matching patterns
+ */
+export declare const toolDefinitionGlob: BrainArch1ToolDefinition;
+/**
+ * .what = executes the glob tool
+ * .why = performs the actual file pattern matching
+ */
+export declare const executeToolGlob: (input: {
+    callId: string;
+    args: {
+        pattern: string;
+        cwd?: string;
+    };
+}) => Promise<BrainArch1ToolResult>;

package/dist/domain.operations/brain.replic.arch1/plugins/toolboxes/files/glob.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeToolGlob = exports.toolDefinitionGlob = exports.schemaGlobInput = void 0;
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const zod_1 = require("zod");
+const BrainArch1ToolDefinition_1 = require("../../../../../domain.objects/BrainArch1/BrainArch1ToolDefinition");
+const BrainArch1ToolResult_1 = require("../../../../../domain.objects/BrainArch1/BrainArch1ToolResult");
+/**
+ * .what = zod schema for glob tool input
+ * .why = enables type-safe validation and json schema generation
+ */
+exports.schemaGlobInput = zod_1.z.object({
+    pattern: zod_1.z
+        .string()
+        .describe('The glob pattern to match files (e.g., "**/*.ts")'),
+    cwd: zod_1.z
+        .string()
+        .optional()
+        .describe('Optional working directory to search from. Defaults to process.cwd().'),
+});
+/**
+ * .what = tool definition for finding files by glob pattern
+ * .why = enables the brain to discover files matching patterns
+ */
+exports.toolDefinitionGlob = new BrainArch1ToolDefinition_1.BrainArch1ToolDefinition({
+    name: 'glob',
+    description: 'Finds files matching a glob pattern. Returns matching file paths.',
+    schema: {
+        input: (0, BrainArch1ToolDefinition_1.toJsonSchema)(exports.schemaGlobInput),
+    },
+    strict: false,
+});
+/**
+ * .what = executes the glob tool
+ * .why = performs the actual file pattern matching
+ */
+const executeToolGlob = async (input) => {
+    try {
+        // find matching files
+        const matches = await (0, fast_glob_1.default)(input.args.pattern, {
+            cwd: input.args.cwd ?? process.cwd(),
+            absolute: true,
+            onlyFiles: true,
+        });
+        // format output
+        const output = matches.length > 0 ? matches.join('\n') : 'no files matched the pattern';
+        return new BrainArch1ToolResult_1.BrainArch1ToolResult({
+            callId: input.callId,
+            success: true,
+            output,
+            error: null,
+        });
+    }
+    catch (err) {
+        const error = err instanceof Error ? err.message : String(err);
+        return new BrainArch1ToolResult_1.BrainArch1ToolResult({
+            callId: input.callId,
+            success: false,
+            output: '',
+            error: `failed to glob: ${error}`,
+        });
+    }
+};
+exports.executeToolGlob = executeToolGlob;
+//# sourceMappingURL=glob.js.map

package/dist/domain.operations/brain.replic.arch1/plugins/toolboxes/files/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../../../../../src/domain.operations/brain.replic.arch1/plugins/toolboxes/files/glob.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA2B;AAC3B,6BAAwB;AAExB,sGAGiE;AACjE,8FAA2F;AAE3F;;;GAGG;AACU,QAAA,eAAe,GAAG,OAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,OAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,mDAAmD,CAAC;IAChE,GAAG,EAAE,OAAC;SACH,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,uEAAuE,CACxE;CACJ,CAAC,CAAC;AAEH;;;GAGG;AACU,QAAA,kBAAkB,GAAG,IAAI,mDAAwB,CAAC;IAC7D,IAAI,EAAE,MAAM;IACZ,WAAW,EACT,mEAAmE;IACrE,MAAM,EAAE;QACN,KAAK,EAAE,IAAA,uCAAY,EAAC,uBAAe,CAAC;KACrC;IACD,MAAM,EAAE,KAAK;CACd,CAAC,CAAC;AAEH;;;GAGG;AACI,MAAM,eAAe,GAAG,KAAK,EAAE,KAGrC,EAAiC,EAAE;IAClC,IAAI,CAAC;QACH,sBAAsB;QACtB,MAAM,OAAO,GAAG,MAAM,IAAA,mBAAE,EAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE;YAC3C,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;YACpC,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,gBAAgB;QAChB,MAAM,MAAM,GACV,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,8BAA8B,CAAC;QAE3E,OAAO,IAAI,2CAAoB,CAAC;YAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,IAAI;YACb,MAAM;YACN,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/D,OAAO,IAAI,2CAAoB,CAAC;YAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,mBAAmB,KAAK,EAAE;SAClC,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC;AA/BW,QAAA,eAAe,mBA+B1B"}

package/dist/domain.operations/brain.replic.arch1/plugins/toolboxes/files/grep.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { BrainArch1ToolDefinition } from '../../../../../domain.objects/BrainArch1/BrainArch1ToolDefinition';
+import { BrainArch1ToolResult } from '../../../../../domain.objects/BrainArch1/BrainArch1ToolResult';
+/**
+ * .what = zod schema for grep tool input
+ * .why = enables type-safe validation and json schema generation
+ */
+export declare const schemaGrepInput: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    glob: z.ZodOptional<z.ZodString>;
+    case_insensitive: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    pattern: string;
+    path?: string | undefined;
+    glob?: string | undefined;
+    case_insensitive?: boolean | undefined;
+}, {
+    pattern: string;
+    path?: string | undefined;
+    glob?: string | undefined;
+    case_insensitive?: boolean | undefined;
+}>;
+/**
+ * .what = tool definition for searching file contents by pattern
+ * .why = enables the brain to search for text patterns in files
+ */
+export declare const toolDefinitionGrep: BrainArch1ToolDefinition;
+/**
+ * .what = executes the grep tool
+ * .why = performs the actual content search operation
+ */
+export declare const executeToolGrep: (input: {
+    callId: string;
+    args: {
+        pattern: string;
+        path?: string;
+        glob?: string;
+        case_insensitive?: boolean;
+    };
+}) => Promise<BrainArch1ToolResult>;