rhachet-roles-bhrain 0.2.0 → 0.5.1

package/dist/domain.operations/review/genTokenBreakdownReport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genTokenBreakdownReport.js","sourceRoot":"","sources":["../../../src/domain.operations/review/genTokenBreakdownReport.ts"],"names":[],"mappings":";;;AAAA,6DAA0D;AAc1D;;;GAGG;AACH,MAAM,YAAY,GAAG,CAAC,MAAc,EAAU,EAAE;IAC9C,IAAI,MAAM,IAAI,OAAS;QAAE,OAAO,GAAG,CAAC,MAAM,GAAG,OAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACtE,IAAI,MAAM,IAAI,IAAK;QAAE,OAAO,GAAG,CAAC,MAAM,GAAG,IAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC9D,OAAO,GAAG,MAAM,EAAE,CAAC;AACrB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,iBAAiB,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAE/E;;;GAGG;AACI,MAAM,uBAAuB,GAAG,CAAC,KAEvC,EAAqD,EAAE;IACtD,4BAA4B;IAC5B,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,IAAA,uCAAkB,EAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7D,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,MAAe;YACrB,MAAM;SACP,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;YACzD,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1E,IAAI;QACJ,IAAI,EAAE,WAAoB;QAC1B,MAAM;KACP,CAAC,CAAC,CAAC;IAEJ,wCAAwC;IACxC,MAAM,UAAU,GAAG,CAAC,GAAG,WAAW,EAAE,GAAG,UAAU,CAAC,CAAC,IAAI,CACrD,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAC9B,CAAC;IAEF,kBAAkB;IAClB,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAEhE,4BAA4B;IAC5B,MAAM,OAAO,GAA0B,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAChE,GAAG,KAAK;QACR,WAAW,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC;QACvC,WAAW,EAAE,GAAG,iBAAiB,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG;KACnE,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC,CAAC;AA/CW,QAAA,uBAAuB,2BA+ClC"}

package/dist/domain.operations/review/invokeClaudeCode.d.ts

@@ -0,0 +1,22 @@
+/**
+ * .what = usage metrics from claude invocation
+ * .why = enables cost tracking and optimization
+ */
+export interface ClaudeUsage {
+    inputTokens: number;
+    inputTokensCacheCreation: number;
+    inputTokensCacheRead: number;
+    outputTokens: number;
+}
+/**
+ * .what = invokes claude-code cli with the prompt
+ * .why = executes the review via the specified brain (claude-code)
+ */
+export declare const invokeClaudeCode: (input: {
+    prompt: string;
+    cwd?: string;
+}) => Promise<{
+    response: object;
+    review: string;
+    usage: ClaudeUsage;
+}>;

package/dist/domain.operations/review/invokeClaudeCode.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invokeClaudeCode = void 0;
+const child_process_1 = require("child_process");
+const helpful_errors_1 = require("helpful-errors");
+/**
+ * .what = invokes claude-code cli with the prompt
+ * .why = executes the review via the specified brain (claude-code)
+ */
+const invokeClaudeCode = async (input) => {
+    // invoke claude-code cli via stdin to avoid E2BIG on large prompts
+    const output = await new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)('claude', ['-p', '-', '--output-format', 'json'], {
+            cwd: input.cwd,
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.on('data', (data) => {
+            stdout += data.toString();
+        });
+        child.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+        child.on('error', reject);
+        child.on('close', (code) => {
+            if (code !== 0) {
+                // check for prompt too long error
+                if (stdout.includes('Prompt is too long')) {
+                    reject(new helpful_errors_1.BadRequestError('prompt is too long for claude context window; reduce --rules or --paths scope', {
+                        status: code,
+                        hint: 'try narrowing your glob patterns or excluding large files',
+                    }));
+                    return;
+                }
+                reject(new helpful_errors_1.UnexpectedCodePathError('claude-code exited with non-zero', {
+                    status: code,
+                    stdout: stdout.slice(0, 2000),
+                    stderr: stderr.slice(0, 2000),
+                }));
+                return;
+            }
+            resolve(stdout);
+        });
+        // write prompt to stdin and close
+        child.stdin.write(input.prompt);
+        child.stdin.end();
+    });
+    // parse the json response
+    const response = (() => {
+        try {
+            return JSON.parse(output);
+        }
+        catch {
+            throw new helpful_errors_1.UnexpectedCodePathError('failed to parse claude-code response', {
+                output,
+            });
+        }
+    })();
+    // extract review content from response
+    const review = (() => {
+        // claude-code json output has a 'result' field with the text content
+        if (response.result && typeof response.result === 'string') {
+            return response.result;
+        }
+        // fallback: look for text in message content
+        if (response.content && Array.isArray(response.content)) {
+            const textContent = response.content.find((c) => c.type === 'text');
+            if (textContent?.text) {
+                return textContent.text;
+            }
+        }
+        throw new helpful_errors_1.UnexpectedCodePathError('failed to extract review from response', {
+            response,
+        });
+    })();
+    // extract usage from response
+    const usage = (() => {
+        if (!response.usage)
+            throw new helpful_errors_1.UnexpectedCodePathError('response.usage not found', {
+                response,
+            });
+        return {
+            inputTokens: response.usage.input_tokens ?? 0,
+            inputTokensCacheCreation: response.usage.cache_creation_input_tokens ?? 0,
+            inputTokensCacheRead: response.usage.cache_read_input_tokens ?? 0,
+            outputTokens: response.usage.output_tokens ?? 0,
+        };
+    })();
+    return { response, review, usage };
+};
+exports.invokeClaudeCode = invokeClaudeCode;
+//# sourceMappingURL=invokeClaudeCode.js.map

package/dist/domain.operations/review/invokeClaudeCode.js.map

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

package/dist/domain.operations/review/writeInputArtifacts.d.ts

@@ -0,0 +1,27 @@
+/**
+ * .what = writes input artifacts to log directory for auditability
+ * .why = enables debugging, replay, and audit of review invocations
+ */
+export declare const writeInputArtifacts: (input: {
+    logDir: string;
+    args: {
+        rules: string | string[];
+        diffs?: string;
+        paths?: string | string[];
+        output: string;
+        mode: 'soft' | 'hard';
+    };
+    scope: {
+        ruleFiles: string[];
+        targetFiles: string[];
+    };
+    metrics: {
+        tokenEstimate: number;
+        contextWindowPercent: number;
+        costEstimate: number;
+    };
+    prompt: string;
+}) => Promise<{
+    argsPath: string;
+    promptPath: string;
+}>;

package/dist/domain.operations/review/writeInputArtifacts.js

@@ -0,0 +1,50 @@
+"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.writeInputArtifacts = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+/**
+ * .what = writes input artifacts to log directory for auditability
+ * .why = enables debugging, replay, and audit of review invocations
+ */
+const writeInputArtifacts = async (input) => {
+    // ensure log directory exists
+    await fs.mkdir(input.logDir, { recursive: true });
+    // write input.args.json
+    const argsPath = path.join(input.logDir, 'input.args.json');
+    const argsContent = JSON.stringify({
+        args: input.args,
+        scope: input.scope,
+        metrics: input.metrics,
+    }, null, 2);
+    await fs.writeFile(argsPath, argsContent, 'utf-8');
+    // write input.prompt.md
+    const promptPath = path.join(input.logDir, 'input.prompt.md');
+    await fs.writeFile(promptPath, input.prompt, 'utf-8');
+    return { argsPath, promptPath };
+};
+exports.writeInputArtifacts = writeInputArtifacts;
+//# sourceMappingURL=writeInputArtifacts.js.map

package/dist/domain.operations/review/writeInputArtifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeInputArtifacts.js","sourceRoot":"","sources":["../../../src/domain.operations/review/writeInputArtifacts.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAAkC;AAClC,2CAA6B;AAE7B;;;GAGG;AACI,MAAM,mBAAmB,GAAG,KAAK,EAAE,KAmBzC,EAAqD,EAAE;IACtD,8BAA8B;IAC9B,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAElD,wBAAwB;IACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAChC;QACE,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,EACD,IAAI,EACJ,CAAC,CACF,CAAC;IACF,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAEnD,wBAAwB;IACxB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC9D,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEtD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAClC,CAAC,CAAC;AAzCW,QAAA,mBAAmB,uBAyC9B"}

package/dist/domain.operations/review/writeOutputArtifacts.d.ts

@@ -0,0 +1,12 @@
+/**
+ * .what = writes output artifacts to log directory for auditability
+ * .why = enables debugging, replay, and audit of review results
+ */
+export declare const writeOutputArtifacts: (input: {
+    logDir: string;
+    response: object;
+    review: string;
+}) => Promise<{
+    responsePath: string;
+    reviewPath: string;
+}>;

package/dist/domain.operations/review/writeOutputArtifacts.js

@@ -0,0 +1,46 @@
+"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.writeOutputArtifacts = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+/**
+ * .what = writes output artifacts to log directory for auditability
+ * .why = enables debugging, replay, and audit of review results
+ */
+const writeOutputArtifacts = async (input) => {
+    // ensure log directory exists (should already exist from writeInputArtifacts)
+    await fs.mkdir(input.logDir, { recursive: true });
+    // write output.response.json
+    const responsePath = path.join(input.logDir, 'output.response.json');
+    const responseContent = JSON.stringify(input.response, null, 2);
+    await fs.writeFile(responsePath, responseContent, 'utf-8');
+    // write output.review.md
+    const reviewPath = path.join(input.logDir, 'output.review.md');
+    await fs.writeFile(reviewPath, input.review, 'utf-8');
+    return { responsePath, reviewPath };
+};
+exports.writeOutputArtifacts = writeOutputArtifacts;
+//# sourceMappingURL=writeOutputArtifacts.js.map

package/dist/domain.operations/review/writeOutputArtifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeOutputArtifacts.js","sourceRoot":"","sources":["../../../src/domain.operations/review/writeOutputArtifacts.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAAkC;AAClC,2CAA6B;AAE7B;;;GAGG;AACI,MAAM,oBAAoB,GAAG,KAAK,EAAE,KAI1C,EAAyD,EAAE;IAC1D,8EAA8E;IAC9E,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAElD,6BAA6B;IAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACrE,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAChE,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;IAE3D,yBAAyB;IACzB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC/D,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEtD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;AACtC,CAAC,CAAC;AAlBW,QAAA,oBAAoB,wBAkB/B"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC"}

package/dist/roles/architect/getArchitectRole.d.ts

@@ -0,0 +1,6 @@
+import { Role } from 'rhachet';
+/**
+ * .what = role definition for the architect
+ * .why = documents and compares architectures of replic brains (LLMs behind REPLs)
+ */
+export declare const ROLE_ARCHITECT: Role;

package/dist/roles/architect/getArchitectRole.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROLE_ARCHITECT = void 0;
+const rhachet_1 = require("rhachet");
+/**
+ * .what = role definition for the architect
+ * .why = documents and compares architectures of replic brains (LLMs behind REPLs)
+ */
+exports.ROLE_ARCHITECT = rhachet_1.Role.build({
+    slug: 'architect',
+    name: 'Architect',
+    purpose: 'brain architecture patterns',
+    readme: `
+## 🏗️ Architect
+
+- **scale**: conceptual, architectural
+- **focus**: brain architecture patterns
+- **maximizes**: understanding of how artificial brains are constructed
+
+used to document and compare architectures of replic brains (LLMs behind REPLs).
+  `.trim(),
+    traits: [],
+    skills: {
+        dirs: [],
+        refs: [],
+    },
+    briefs: {
+        dirs: [{ uri: __dirname + '/briefs' }],
+    },
+});
+//# sourceMappingURL=getArchitectRole.js.map

package/dist/roles/architect/getArchitectRole.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getArchitectRole.js","sourceRoot":"","sources":["../../../src/roles/architect/getArchitectRole.ts"],"names":[],"mappings":";;;AAAA,qCAA+B;AAE/B;;;GAGG;AACU,QAAA,cAAc,GAAS,cAAI,CAAC,KAAK,CAAC;IAC7C,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,6BAA6B;IACtC,MAAM,EAAE;;;;;;;;GAQP,CAAC,IAAI,EAAE;IACR,MAAM,EAAE,EAAE;IACV,MAAM,EAAE;QACN,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,EAAE;KACT;IACD,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;KACvC;CACF,CAAC,CAAC"}

package/dist/roles/brain/getBrainRole.d.ts

@@ -0,0 +1,6 @@
+import { Role } from 'rhachet';
+/**
+ * .what = role definition for the brain
+ * .why = exposes agentic capabilities as rhachet skills for tool-using llm workflows
+ */
+export declare const ROLE_BRAIN: Role;

package/dist/roles/brain/getBrainRole.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROLE_BRAIN = void 0;
+const rhachet_1 = require("rhachet");
+const skillAct_1 = require("../../roles/brain/skills/act/skillAct");
+/**
+ * .what = role definition for the brain
+ * .why = exposes agentic capabilities as rhachet skills for tool-using llm workflows
+ */
+exports.ROLE_BRAIN = rhachet_1.Role.build({
+    slug: 'brain',
+    name: 'Brain',
+    purpose: 'agentic entooled brain',
+    readme: `
+## 🧠 Brain
+
+a brain.repl available for agentic tooluse
+  `.trim(),
+    traits: [],
+    skills: {
+        dirs: [],
+        refs: [skillAct_1.SKILL_ACT],
+    },
+    briefs: {
+        dirs: [],
+    },
+});
+//# sourceMappingURL=getBrainRole.js.map

package/dist/roles/brain/getBrainRole.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBrainRole.js","sourceRoot":"","sources":["../../../src/roles/brain/getBrainRole.ts"],"names":[],"mappings":";;;AAAA,qCAA+B;AAE/B,mEAAiE;AAEjE;;;GAGG;AACU,QAAA,UAAU,GAAS,cAAI,CAAC,KAAK,CAAC;IACzC,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,wBAAwB;IACjC,MAAM,EAAE;;;;GAIP,CAAC,IAAI,EAAE;IACR,MAAM,EAAE,EAAE;IACV,MAAM,EAAE;QACN,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,CAAC,oBAAS,CAAC;KAClB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,EAAE;KACT;CACF,CAAC,CAAC"}

package/dist/roles/brain/skills/act/skillAct.d.ts

@@ -0,0 +1,5 @@
+/**
+ * .what = skill definition for agentic task completion
+ * .why = enables rhachet roles to leverage brain capabilities for autonomous task execution
+ */
+export declare const SKILL_ACT: import("rhachet").RoleSkill<import("./stepAct").StitcherAct>;

package/dist/roles/brain/skills/act/skillAct.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_ACT = void 0;
+const rhachet_1 = require("rhachet");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+const genContextLogTrail_1 = require("../../../../.test/genContextLogTrail");
+const BrainArch1Actor_1 = require("../../../../domain.objects/BrainArch1/BrainArch1Actor");
+const anthropic_1 = require("../../../../domain.operations/brain.replic.arch1/plugins/atoms/anthropic");
+const openai_1 = require("../../../../domain.operations/brain.replic.arch1/plugins/atoms/openai");
+const qwen_1 = require("../../../../domain.operations/brain.replic.arch1/plugins/atoms/qwen");
+const readOnly_1 = require("../../../../domain.operations/brain.replic.arch1/plugins/permissionGuards/readOnly");
+const files_1 = require("../../../../domain.operations/brain.replic.arch1/plugins/toolboxes/files");
+const stepAct_1 = require("./stepAct");
+/**
+ * .what = skill definition for agentic task completion
+ * .why = enables rhachet roles to leverage brain capabilities for autonomous task execution
+ */
+exports.SKILL_ACT = (0, rhachet_1.genRoleSkill)({
+    slug: 'act',
+    route: stepAct_1.stepAct,
+    threads: {
+        lookup: {
+            target: {
+                source: 'process.argv',
+                char: 't',
+                desc: 'the target file to write the result to',
+                type: 'string',
+            },
+            provider: {
+                source: 'process.argv',
+                char: 'p',
+                desc: 'the llm provider to use (anthropic, openai, qwen)',
+                type: '?string',
+            },
+            model: {
+                source: 'process.argv',
+                char: 'm',
+                desc: 'the model to use',
+                type: '?string',
+            },
+            system: {
+                source: 'process.argv',
+                char: 's',
+                desc: 'path to system prompt file',
+                type: '?string',
+            },
+        },
+        assess: (input) => typeof input.target === 'string',
+        instantiate: async (input) => {
+            const obsDir = (0, rhachet_artifact_git_1.getArtifactObsDir)({ uri: input.target });
+            // build brain actor from inputs
+            const provider = (input.provider ?? 'anthropic');
+            const model = input.model ?? 'claude-3-5-sonnet-latest';
+            // create atom based on provider
+            const atom = provider === 'anthropic'
+                ? (0, anthropic_1.genAtomAnthropic)({ model })
+                : provider === 'openai'
+                    ? (0, openai_1.genAtomOpenai)({ model })
+                    : (0, qwen_1.genAtomQwen)({ model });
+            const actor = new BrainArch1Actor_1.BrainArch1Actor({
+                atom,
+                toolboxes: [files_1.toolboxFiles],
+                memory: null,
+                permission: readOnly_1.permissionGuardReadOnly,
+                constraints: {
+                    maxIterations: 100,
+                    maxTokens: 8192,
+                },
+                role: {
+                    systemPrompt: null,
+                },
+            });
+            return {
+                caller: await (0, rhachet_1.enrollThread)({
+                    role: 'caller',
+                    stash: {
+                        ask: input.ask,
+                        art: {
+                            result: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: input.target }, { versions: true }),
+                            log: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.log.md' }, { versions: true }),
+                        },
+                    },
+                }),
+                brain: await (0, rhachet_1.enrollThread)({
+                    role: 'brain',
+                    stash: {
+                        actor,
+                        systemPromptPath: input.system ?? null,
+                    },
+                }),
+            };
+        },
+    },
+    context: {
+        lookup: {
+            apiKeyAnthropic: {
+                source: 'process.env',
+                envar: 'ANTHROPIC_API_KEY',
+                desc: 'the anthropic api key',
+                type: '?string',
+            },
+            apiKeyOpenai: {
+                source: 'process.env',
+                envar: 'OPENAI_API_KEY',
+                desc: 'the openai api key',
+                type: '?string',
+            },
+            apiKeyQwen: {
+                source: 'process.env',
+                envar: 'QWEN_API_KEY',
+                desc: 'the qwen api key',
+                type: '?string',
+            },
+            apiKeyTavily: {
+                source: 'process.env',
+                envar: 'TAVILY_API_KEY',
+                desc: 'the tavily api key for web search',
+                type: '?string',
+            },
+        },
+        assess: (input) => true,
+        instantiate: (input) => {
+            return {
+                creds: {
+                    anthropic: { apiKey: input.apiKeyAnthropic ?? '', url: null },
+                    openai: { apiKey: input.apiKeyOpenai ?? '', url: null },
+                    qwen: { apiKey: input.apiKeyQwen ?? '', url: null },
+                    tavily: { apiKey: input.apiKeyTavily ?? '' },
+                },
+                ...(0, genContextLogTrail_1.genContextLogTrail)(),
+                ...(0, rhachet_1.genContextStitchTrail)(),
+            };
+        },
+    },
+    readme: `
+# act
+
+invokes the agentic brain loop to complete a task
+
+## usage
+
+\`\`\`bash
+npx rhachet skills run act -t ./output.md "your task here"
+\`\`\`
+  `.trim(),
+});
+//# sourceMappingURL=skillAct.js.map

package/dist/roles/brain/skills/act/skillAct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillAct.js","sourceRoot":"","sources":["../../../../../src/roles/brain/skills/act/skillAct.ts"],"names":[],"mappings":"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"}