rhachet-roles-ehmpathy 1.1.0 → 1.3.0

package/dist/logic/roles/bhrain/khue.cluster/stepCluster.skill.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_CLUSTER = void 0;
+const rhachet_1 = require("rhachet");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+const genContextLogTrail_1 = require("../../../../.test/genContextLogTrail");
+const genContextStitchTrail_1 = require("../../../../.test/genContextStitchTrail");
+const getContextOpenAI_1 = require("../../../../.test/getContextOpenAI");
+const stepCluster_1 = require("./stepCluster");
+exports.SKILL_CLUSTER = (0, rhachet_1.genRoleSkill)({
+    slug: 'cluster',
+    route: stepCluster_1.loopCluster,
+    threads: {
+        lookup: {
+            output: {
+                source: 'process.argv',
+                char: 'o',
+                desc: 'the output file to write against',
+                type: 'string',
+            },
+            input: {
+                source: 'process.argv',
+                char: 'i',
+                desc: 'the input file to seed from',
+                type: 'string',
+            },
+            goal: {
+                source: 'process.argv',
+                char: 'g',
+                desc: 'the goal of the request',
+                type: '?string',
+            },
+            references: {
+                source: 'process.argv',
+                char: 'f',
+                desc: 'reference files to to use, if any; delimit with commas',
+                type: '?string',
+            },
+            briefs: {
+                source: 'process.argv',
+                char: 'b',
+                desc: 'brief files to to use, if any; delimit with commas',
+                type: '?string',
+            },
+        },
+        assess: (input) => typeof input.output === 'string',
+        instantiate: async (input) => {
+            // declare where all the artifacts will be found
+            const obsDir = (0, rhachet_artifact_git_1.getArtifactObsDir)({ uri: input.output });
+            const artifacts = {
+                goal: {
+                    concept: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.goal.concept.md' }, { versions: true }),
+                    context: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.goal.context.md' }, { versions: true }),
+                },
+                feedback: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.feedback.md' }, { versions: true }),
+                'focus.context': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.focus.context.md' }, { versions: true }),
+                'focus.concept': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: input.output }, { versions: true }),
+                input: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: input.input }, { versions: true }),
+                references: input.references
+                    ?.split(',')
+                    .filter((uri) => !!uri)
+                    .map((reference) => (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: reference }, { access: 'readonly' })) ?? [],
+                briefs: input.briefs
+                    ?.split(',')
+                    .filter((uri) => !!uri)
+                    .map((brief) => (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: brief }, { access: 'readonly' })) ?? [],
+            };
+            // detect the goal of the caller
+            const goalConcept = await (async () => {
+                // if goal explicitly defined, use it
+                if (input.goal)
+                    return ((await (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: input.goal }, { access: 'readonly' }).get())?.content ?? input.ask);
+                // otherwise, assume its the ask
+                return input.ask;
+            })();
+            await artifacts.goal.concept.set({ content: goalConcept });
+            return {
+                caller: await (0, rhachet_1.enrollThread)({
+                    role: 'caller',
+                    stash: {
+                        ask: '',
+                        art: {
+                            'foci.goal.concept': artifacts.goal.concept,
+                            'foci.goal.context': artifacts.goal.context,
+                            'foci.input.concept': artifacts.input,
+                            feedback: artifacts.feedback,
+                        },
+                        refs: artifacts.references,
+                    },
+                }),
+                thinker: await (0, rhachet_1.enrollThread)({
+                    role: 'thinker',
+                    stash: {
+                        art: {
+                            'focus.context': artifacts['focus.context'],
+                            'focus.concept': artifacts['focus.concept'],
+                        },
+                        briefs: [
+                            ...artifacts.briefs,
+                            ...stepCluster_1.BRIEFS_FOR_CLUSTER, // flow the cluster briefs down so that <ponder> has them in context too; this approach does cause duplicate briefs for cluster, but thats no biggie
+                        ],
+                    },
+                }),
+            };
+        },
+    },
+    context: {
+        lookup: {
+            apiKeyOpenai: {
+                source: 'process.env',
+                envar: 'PREP_OPENAI_KEY',
+                desc: 'the openai key to use',
+                type: 'string',
+            },
+        },
+        assess: (input) => typeof input.apiKeyOpenai === 'string',
+        instantiate: () => {
+            return {
+                ...(0, getContextOpenAI_1.getContextOpenAI)(),
+                ...(0, genContextLogTrail_1.genContextLogTrail)(),
+                ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+            };
+        },
+    },
+    readme: '',
+});
+//# sourceMappingURL=stepCluster.skill.js.map

package/dist/logic/roles/bhrain/khue.cluster/stepCluster.skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepCluster.skill.js","sourceRoot":"","sources":["../../../../../src/logic/roles/bhrain/khue.cluster/stepCluster.skill.ts"],"names":[],"mappings":"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"}

package/dist/logic/roles/bhrain/khue.cluster/stepCluster.template.md

@@ -0,0 +1,134 @@
+# 🗣️ prompt: `<cluster>` — group related elements into cohesive clusters
+
+You are a **@[thinker]** performing the **generation tactic** `<cluster>`.
+
+---
+
+## 📜 contract
+For `<cluster>` to work as intended:
+
+- **input = [concepts]**
+  - the input must be a **list of concepts, ideas, or data points**.
+  - these may come from scratch, a seed, or inflight context.
+  - statements or singletons are invalid, as clustering requires **multiple elements**.
+
+- **output = [clusters]**
+  - the output must be a **set of clusters**, where each cluster contains:
+    - a **cluster label** (short, descriptive name)
+    - a **list of member concepts** (from the input)
+    - a **rationale** explaining why those elements belong together
+
+- **error guard**: if fewer than two concepts are provided, return
+  `"BadRequestError: input must contain at least two concepts"`
+
+**why this contract exists:**
+- clustering is meaningful only when applied to **multiple elements**
+- each cluster must be **cohesive and distinct**, avoiding overlap or redundancy
+- rationales ensure clusters are **interpretable and justifiable**, not arbitrary groupings
+
+---
+
+## ⚙️ method
+1. **identify elements**
+   - parse the input list of concepts
+   - ensure diversity and representativeness
+
+2. **determine criteria**
+   - infer shared attributes, functions, or purposes
+   - apply criteria consistently across all elements
+
+3. **analyze and group**
+   - assign elements into cohesive clusters
+   - ensure clusters are **balanced** (not too granular, not too broad)
+
+4. **review and refine**
+   - check clusters for clarity, coherence, and distinctiveness
+   - adjust groupings where necessary
+
+---
+
+## 📐 output format
+- Return **only** a JSON array of clusters.
+- Each cluster must be an object with three keys:
+  - `"label"`: a short descriptive name for the cluster
+  - `"members"`: an array of the included input concepts
+  - `"rationale"`: a short explanation of why these elements belong together
+
+Example schema (do not include this in output, just follow the format):
+\`\`\`json
+[
+  {
+    "label": "Cluster A",
+    "members": ["concept1", "concept2"],
+    "rationale": "why these belong together"
+  }
+]
+\`\`\`
+
+- The array **must contain at least two clusters**.
+- Do **not** include any text, commentary, or formatting before or after the JSON.
+
+---
+
+## 📚 briefs
+
+here are the .briefs you've studied for this skill and actively strive to leverage
+
+$.rhachet{skill.briefs}
+
+---
+
+## 📥 inputs
+
+the following inputs define the semantic frame for `<cluster>`:
+
+---
+
+## 📎 references
+
+here are possibly relevant references you may need
+
+$.rhachet{references}
+
+---
+
+### 🧘 @[focus.context]
+\`\`\`md
+$.rhachet{focus.context}
+\`\`\`
+
+---
+
+### 🫐 @[focus.concept]
+> the inflight document — the seed brief being refined by `<cluster>`
+> if empty, treat as **no seed** and start fresh
+
+\`\`\`md
+$.rhachet{focus.concept}
+\`\`\`
+
+---
+
+### 🎯 @[guide.goal]
+
+> the goal, used to help determine along which dimensions to cluster
+
+\`\`\`md
+$.rhachet{guide.goal}
+\`\`\`
+
+---
+
+### 💬 @[guide.feedback]
+\`\`\`md
+$.rhachet{guide.feedback}
+\`\`\`
+
+---
+
+### 🌱 [concepts]
+\`\`\`md
+$.rhachet{seed.concepts}
+\`\`\`
+
+**note: if fewer than two concepts are provided, simply return `"BadRequestError: input must contain at least two concepts"`**

package/dist/logic/roles/bhrain/{primitive.idealogic.atomic/diverge → khue.diverge}/stepDiverge.d.ts

@@ -1,20 +1,25 @@
 import { GStitcher, Threads, RoleContext } from 'rhachet';
 import { Artifact } from 'rhachet-artifact';
 import { GitFile } from 'rhachet-artifact-git';
-import { ContextOpenAI } from '../../../../../data/sdk/sdkOpenAi';
+import { Focus } from '../../../../_topublish/rhachet-roles-bhrain/src/domain/objects/Focus';
+import { ContextOpenAI } from '../../../../data/sdk/sdkOpenAi';
+export declare const BRIEFS_FOR_DIVERGE: Artifact<typeof GitFile, string>[];
 type StitcherDesired = GStitcher<Threads<{
     caller: RoleContext<'caller', {
         ask: string;
         art: {
             feedback: Artifact<typeof GitFile>;
+            'foci.goal.concept': Focus['concept'];
+            'foci.goal.context': Focus['context'];
         };
+        refs: Artifact<typeof GitFile>[];
     }>;
     thinker: RoleContext<'thinker', {
         art: {
-            inflight: Artifact<typeof GitFile>;
+            'focus.concept': Focus['concept'];
+            'focus.context': Focus['context'];
         };
-        purpose: string;
-        grammar: string;
+        briefs: Artifact<typeof GitFile>[];
     }>;
 }>, ContextOpenAI & GStitcher['context'], {
     content: string;
@@ -25,7 +30,10 @@ export declare const loopDiverge: import("rhachet").Stitcher<GStitcher<Threads<{
         ask: string;
         art: {
             feedback: Artifact<typeof GitFile>;
+            'foci.goal.concept': Focus['concept'];
+            'foci.goal.context': Focus['context'];
         };
+        refs: Artifact<typeof GitFile>[];
     } & {
         ask: string;
         art: {
@@ -34,13 +42,13 @@ export declare const loopDiverge: import("rhachet").Stitcher<GStitcher<Threads<{
     }>;
     thinker: RoleContext<"thinker", {
         art: {
-            inflight: Artifact<typeof GitFile>;
+            'focus.concept': Focus['concept'];
+            'focus.context': Focus['context'];
         };
-        purpose: string;
-        grammar: string;
+        briefs: Artifact<typeof GitFile>[];
     } & {
         art: {
-            inflight: Artifact<typeof GitFile, string>;
+            "focus.concept": Artifact<typeof GitFile, string>;
         };
     }>;
 }>, ContextOpenAI & import("simple-log-methods").ContextLogTrail & import("rhachet").ContextStitchTrail, {

package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.integration.test.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const uni_time_1 = require("@ehmpathy/uni-time");
+const rhachet_1 = require("rhachet");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+const test_fns_1 = require("test-fns");
+const genContextLogTrail_1 = require("../../../../.test/genContextLogTrail");
+const genContextStitchTrail_1 = require("../../../../.test/genContextStitchTrail");
+const getContextOpenAI_1 = require("../../../../.test/getContextOpenAI");
+const getBhrainBrief_1 = require("../getBhrainBrief");
+const stepDiverge_1 = require("./stepDiverge");
+jest.setTimeout((0, uni_time_1.toMilliseconds)({ minutes: 5 }));
+describe('stepDiverge', () => {
+    const context = {
+        ...(0, genContextLogTrail_1.genContextLogTrail)(),
+        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+        ...(0, getContextOpenAI_1.getContextOpenAI)(),
+    };
+    const route = stepDiverge_1.stepDiverge;
+    const artifacts = {
+        caller: {
+            feedback: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/stepDiverge/caller.feedback.md' }, { versions: true }),
+            'foci.goal.concept': (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                uri: __dirname + '/.temp/stepDiverge/caller.foci.goal.concept.md',
+            }, { versions: true }),
+            'foci.goal.context': (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                uri: __dirname + '/.temp/stepDiverge/caller.foci.goal.context.md',
+            }, { versions: true }),
+        },
+        thinker: {
+            'focus.concept': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/stepDiverge/thinker.focus.concept.md' }, { versions: true }),
+            'focus.context': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/stepDiverge/thinker.focus.context.md' }, { versions: true }),
+        },
+    };
+    (0, test_fns_1.given)('we want to diverge term joke', () => {
+        const goalStatement = `
+    diverge 21 examples of "joke"
+      `.trim();
+        const goalQuestion = `
+    what are 21 examples of a joke?
+      `.trim();
+        beforeEach(async () => {
+            await artifacts.caller.feedback.set({ content: '' });
+            await artifacts.thinker['focus.context'].set({
+                content: ['psychology', 'evolution', 'ecology'].join('\n'),
+            });
+            await artifacts.thinker['focus.concept'].set({
+                content: [].join('\n'),
+            });
+        });
+        const enthread = (input) => (0, test_fns_1.usePrep)(async () => ({
+            caller: await (0, rhachet_1.enrollThread)({
+                role: 'caller',
+                stash: {
+                    ask: input.ask,
+                    art: {
+                        'foci.goal.concept': artifacts.caller['foci.goal.concept'],
+                        'foci.goal.context': artifacts.caller['foci.goal.context'],
+                        feedback: artifacts.caller.feedback,
+                    },
+                    refs: [],
+                },
+            }),
+            thinker: await (0, rhachet_1.enrollThread)({
+                role: 'thinker',
+                stash: {
+                    art: {
+                        'focus.context': artifacts.thinker['focus.context'],
+                        'focus.concept': artifacts.thinker['focus.concept'],
+                    },
+                    briefs: [],
+                },
+                inherit: {
+                    traits: (0, getBhrainBrief_1.getBhrainBriefs)(['trait.ocd.md']),
+                },
+            }),
+        }));
+        (0, test_fns_1.when)('goal is a question', () => {
+            beforeEach(async () => {
+                await artifacts.caller['foci.goal.concept'].set({
+                    content: goalQuestion,
+                });
+            });
+            const goalThreads = enthread({ ask: goalQuestion });
+            (0, test_fns_1.then)('outputs answers', async () => {
+                const result = await (0, rhachet_1.enweaveOneStitcher)({ stitcher: route, threads: goalThreads }, context);
+                console.log(JSON.stringify(result.stitch, null, 2));
+                console.log(artifacts);
+                console.log(artifacts.thinker['focus.concept']);
+                const { content } = await artifacts.thinker['focus.concept']
+                    .get()
+                    .expect('isPresent');
+                expect(content.toLowerCase()).toMatch(/knock[- ]knock|chicken|atom/i);
+            });
+        });
+        (0, test_fns_1.when)('goal is a statement', () => {
+            beforeEach(async () => {
+                await artifacts.caller['foci.goal.concept'].set({
+                    content: goalStatement,
+                });
+            });
+            const goalThreads = enthread({ ask: goalStatement });
+            (0, test_fns_1.then)('outputs BadRequestError', async () => {
+                const result = await (0, rhachet_1.enweaveOneStitcher)({ stitcher: route, threads: goalThreads }, context);
+                console.log(JSON.stringify(result.stitch, null, 2));
+                console.log(artifacts.thinker['focus.concept']);
+                const { content } = await artifacts.thinker['focus.concept']
+                    .get()
+                    .expect('isPresent');
+                expect(content).toContain('BadRequestError');
+            });
+        });
+    });
+});
+//# sourceMappingURL=stepDiverge.integration.test.js.map

package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepDiverge.integration.test.js","sourceRoot":"","sources":["../../../../../src/logic/roles/bhrain/khue.diverge/stepDiverge.integration.test.ts"],"names":[],"mappings":"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"}

package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loopDiverge = exports.stepDiverge = exports.BRIEFS_FOR_DIVERGE = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const rhachet_1 = require("rhachet");
+const wrapper_fns_1 = require("wrapper-fns");
+const sdkOpenAi_1 = require("../../../../data/sdk/sdkOpenAi");
+const genLoopFeedback_1 = require("../../../artifact/genLoopFeedback");
+const genStepArtSet_1 = require("../../../artifact/genStepArtSet");
+const getBhrainBrief_1 = require("../getBhrainBrief");
+// exported so that we can pass them through to <ponder> too
+exports.BRIEFS_FOR_DIVERGE = (0, getBhrainBrief_1.getBhrainBriefs)([
+    'trait.ocd.md',
+    'cognition/cog401.questions.._.md',
+    'cognition/cog000.overview.and.premise.md',
+    'cognition/cog101.concept.treestruct._.md',
+    'cognition/cog201.cortal.focus.p1.definition.md',
+    'cognition/cog301.traversal.1.motion.primitives._.md',
+    'cognition/cog401.questions.._.md',
+    'cognition/cog401.questions.2.1.primitives.rough._.md',
+    'librarian.tactics/<articulate>._.[article].frame.cognitive.md', // todo: keep or remove
+    'librarian.tactics/<articulate>._.[article].frame.tactical.md',
+    'cognition/cog201.cortal.focus.p2.breadth.md',
+    'cognition/cog301.traversal.1.motion.primitives.breadth.md',
+    'cognition/cog301.traversal.1.motion.primitives.breadth.vary.md',
+    'thinker.tactics/<diverge>._.[article].frame.tactical.md',
+    'librarian.tactics/[brief].verbiage.outline.over.narrative.md',
+]);
+const template = (0, rhachet_1.genTemplate)({
+    ref: { uri: __filename.replace('.ts', '.template.md') },
+    getVariables: async ({ threads }) => ({
+        ...(await (0, rhachet_1.getTemplateVarsFromRoleInherit)({ thread: threads.thinker })),
+        guide: {
+            goal: (await threads.caller.context.stash.art['foci.goal.concept'].get())
+                ?.content ||
+                helpful_errors_1.UnexpectedCodePathError.throw('goal not declared', {
+                    art: threads.caller.context.stash.art['foci.goal.concept'],
+                }),
+            feedback: (await threads.caller.context.stash.art.feedback.get())?.content || '',
+        },
+        focus: {
+            context: (await threads.thinker.context.stash.art['focus.context'].get())
+                ?.content ||
+                (await threads.caller.context.stash.art['foci.goal.context'].get()) // fallback to @[caller].focus[goal].context
+                    ?.content ||
+                '',
+            concept: (await threads.thinker.context.stash.art['focus.concept'].get())
+                ?.content || '',
+        },
+        // todo: clarify to callers that foci.goal.concept is used as the [seed][question]; todo: distinguish guide.goal as focus.supergoal, seed.question as subgoal focus
+        seed: {
+            question: (await threads.caller.context.stash.art['foci.goal.concept'].get())
+                ?.content ||
+                helpful_errors_1.UnexpectedCodePathError.throw('goal not declared', {
+                    art: threads.caller.context.stash.art['foci.goal.concept'],
+                }),
+        },
+        skill: {
+            briefs: await (0, rhachet_1.getTemplateValFromArtifacts)({
+                artifacts: [
+                    ...exports.BRIEFS_FOR_DIVERGE,
+                    ...threads.thinker.context.stash.briefs,
+                ],
+            }),
+        },
+        references: await (0, rhachet_1.getTemplateValFromArtifacts)({
+            artifacts: threads.caller.context.stash.refs,
+        }),
+    }),
+});
+const stepImagine = (0, rhachet_1.genStepImagineViaTemplate)({
+    slug: '@[thinker]<diverge>',
+    stitchee: 'thinker',
+    readme: '',
+    template,
+    imagine: (0, wrapper_fns_1.withRetry)((0, wrapper_fns_1.withTimeout)(sdkOpenAi_1.sdkOpenAi.imagine, { threshold: { seconds: 60 } })),
+});
+const stepPersist = (0, genStepArtSet_1.genStepArtSet)({
+    stitchee: 'thinker',
+    artee: 'focus.concept',
+});
+exports.stepDiverge = (0, rhachet_1.asStitcherFlat)((0, rhachet_1.genStitchRoute)({
+    slug: '@[thinker]<diverge>',
+    readme: '@[thinker]<diverge> -> [article]',
+    sequence: [stepImagine, stepPersist],
+}));
+exports.loopDiverge = (0, genLoopFeedback_1.genLoopFeedback)({
+    stitchee: 'thinker',
+    artee: 'focus.concept',
+    repeatee: exports.stepDiverge,
+});
+//# sourceMappingURL=stepDiverge.js.map

package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepDiverge.js","sourceRoot":"","sources":["../../../../../src/logic/roles/bhrain/khue.diverge/stepDiverge.ts"],"names":[],"mappings":"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"}

package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.skill.d.ts

@@ -0,0 +1,29 @@
+export declare const SKILL_DIVERGE: import("rhachet").RoleSkill<import("rhachet").GStitcher<import("rhachet").Threads<{
+    caller: import("rhachet").RoleContext<"caller", {
+        ask: string;
+        art: {
+            feedback: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+            'foci.goal.concept': import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+            'foci.goal.context': import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+        refs: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>[];
+    } & {
+        ask: string;
+        art: {
+            feedback: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    }>;
+    thinker: import("rhachet").RoleContext<"thinker", {
+        art: {
+            'focus.concept': import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+            'focus.context': import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+        briefs: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>[];
+    } & {
+        art: {
+            "focus.concept": import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    }>;
+}>, import("../../../../data/sdk/sdkOpenAi").ContextOpenAI & import("simple-log-methods").ContextLogTrail & import("rhachet").ContextStitchTrail, {
+    feedback: import("rhachet-artifact-git").GitFile | null;
+}>>;