rhachet-roles-ehmpathy 1.15.12 → 1.15.14

package/dist/roles/bhrain/khue.triage/stepTriage.skill.d.ts

@@ -1,29 +0,0 @@
-export declare const SKILL_TRIAGE: import("rhachet").RoleSkill<import("rhachet").GStitcher<import("rhachet").Threads<{
-    caller: import("rhachet").RoleContext<"caller", {
-        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>;
-            'foci.input.concept': 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("../../../access/sdk/sdkOpenAi").ContextOpenAI & import("as-procedure").ContextLogTrail & import("rhachet").ContextStitchTrail, {
-    feedback: import("rhachet-artifact-git").GitFile | null;
-}>>;

package/dist/roles/bhrain/khue.triage/stepTriage.skill.js

@@ -1,127 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SKILL_TRIAGE = 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 stepTriage_1 = require("./stepTriage");
-exports.SKILL_TRIAGE = (0, rhachet_1.genRoleSkill)({
-    slug: 'triage',
-    route: stepTriage_1.loopTriage,
-    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,
-                            ...stepTriage_1.BRIEFS_FOR_TRIAGE, // flow the triage briefs down so that <ponder> has them in context too; this approach does cause duplicate briefs for triage, 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=stepTriage.skill.js.map

package/dist/roles/bhrain/khue.triage/stepTriage.skill.js.map

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

package/dist/roles/bhrain/khue.triage/stepTriage.template.md

@@ -1,128 +0,0 @@
-# 🗣️ prompt: `<triage>` — prioritize and sort concepts by guiding questions
-
-You are a **@[thinker]** performing the **prioritization tactic** `<triage>`.
-
----
-
-## 📜 contract
-For `<triage>` to work as intended:
-
-input = [seed][concepts]
-- a **list of concepts** (tasks, ideas, issues, or elements) to be triaged
-- the list may be long, unordered, and heterogeneous
-
-output = [prioritized][concepts]
-- the same concepts, but **sorted and grouped by priority grades derived from context**
-- **every placed concept must include a concise rationale** explaining *why* it belongs in that grade, referencing the guiding questions/criteria
-- if the input is not a list, simply output:
-  `"BadRequestError: input must be a list of concepts"`
-
-**why this contract exists:**
-- triage is a **question-driven process**; prioritization only makes sense relative to guiding criteria
-- a **context-dependent grading scale** keeps results faithful to domain constraints
-- attaching a **rationale** to each placement makes decisions transparent, reviewable, and improvable
-
----
-
-## ⚙️ method
-1. **anchor to the seed concepts**
-   - parse and restate the full set of concepts needing triage
-   - confirm the scope of assessment (what kinds of concepts are included)
-
-2. **establish criteria (via guiding questions)**
-   - identify the **key questions** that define the triage dimensions
-   - e.g., “which are most urgent?”, “which yield the highest impact?”, “which are prerequisites?”, “which are low-effort/high-gain?”
-
-3. **derive a grading scale from context**
-   - synthesize **grade names** from the criteria and environment (examples: `critical`, `urgent`, `near_term`, `strategic`, `defer`, etc.)
-   - prefer **3–5 distinct grades** that are mutually exclusive and collectively exhaustive for the current context
-   - order grades from highest to lowest priority
-
-4. **evaluate and sort with rationale**
-   - for each concept:
-     - place it under exactly one grade
-     - provide a **rationale**: a crisp, criteria-referenced explanation (impact, urgency, dependency, risk, effort, alignment)
-
-5. **review and refine**
-   - merge duplicates, clarify ambiguous items
-   - verify no concept is added/removed relative to the input
-   - ensure rationales are specific (avoid generic statements)
-
----
-
-## 📐 output format
-- Return **only** a JSON object of the shape:
-
-\`\`\`json
-{
-  "$grade": [
-    { "item": "<exact input concept>", "rationale": "<why this grade, tied to criteria>" }
-  ]
-}
-\`\`\`
-
-- **`$grade` keys** must be **derived from the context and guiding questions** (not hard-coded).
-- **Every array entry** must be an object with **`item`** and **`rationale`**.
-- **Only use items from the input list**; do **not** invent new concepts.
-- Do **not** include any other text, formatting, or commentary 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 `<triage>`:
-
----
-
-## 📎 references
-here are possibly relevant references you may need
-
-$.rhachet{references}
-
----
-
-### 🧘 @[focus.context]
-> the context in focus available for leverage
-
-\`\`\`md
-$.rhachet{focus.context}
-\`\`\`
-
----
-
-### 🫐 @[focus.concept]
-> the **inflight document of output** — the seed concepts being refined by `<triage>`
-> if this is empty, treat it as **no concepts** and start from scratch
-
-\`\`\`md
-$.rhachet{focus.concept}
-\`\`\`
-
----
-
-### 🎯 @[guide.goal]
-\`\`\`md
-$.rhachet{guide.goal}
-\`\`\`
-
----
-
-### 💬 @[guide.feedback]
-\`\`\`md
-$.rhachet{guide.feedback}
-\`\`\`
-
----
-
-### 🌱 [seed][concepts]
-\`\`\`md
-$.rhachet{seed.concepts}
-\`\`\`
-
-**note: if [seed][concepts] is not a list, simply return "BadRequestError: input must be a list of concepts"**

package/dist/roles/coach/.briefs/claude.context-caching.md

@@ -1,76 +0,0 @@
-# 🧠 .brief: Claude Context Caching
-
-## .what
-Claude's context caching mechanism that reduces token costs by caching prompt prefixes
-
-## .how.it.works
-
-### cache key = exact prefix match
-- Claude caches content based on the **exact sequence of tokens from the start** of the conversation
-- a cache hit requires the **exact same prefix** to be present
-- cache is valid for ~5 minutes of inactivity
-
-### prefix-based matching
-```
-Turn 1: [system prompt] + [briefs: 30k tokens] → writes to cache
-Turn 2: [system prompt] + [briefs: 30k tokens] + [user msg] + [response] → cache hit ✅
-Turn 3: [system prompt] + [briefs: 30k tokens] + [history] + [new msg] → cache hit ✅
-```
-
-### when cache hits occur
-
-✅ **cache hit (free reads)** when:
-- the content appears at the **exact same position** in the context
-- everything before it is **identical** to the cached version
-- less than ~5 minutes of inactivity
-
-❌ **cache miss (full tokens charged)** when:
-- anything changed in the context **before** the cached content (even a single token)
-- the content moved to a different position in the conversation
-- more than ~5 minutes passed with no activity
-- new conversation started (different session)
-
-## .implications.for.briefs
-
-### sessionstart hooks
-when loading briefs via sessionstart hooks:
-
-1. **first boot**: full tokens cached (e.g., 30k tokens written to cache)
-2. **within same session**: cached if prefix matches (free reads)
-3. **new session**: full tokens charged again (new conversation = different prefix)
-
-### optimization strategies
-to maximize cache hits:
-
-1. **load briefs once per session** (sessionstart hook pattern)
-2. **keep them at consistent position** (ideally at the start)
-3. **avoid regenerating them** if content hasn't changed
-4. **batch related work** in same session to reuse cache
-
-## .key.insight
-
-the cache **does not move tokens around** or do LRU eviction - it's purely prefix-based matching
-
-this means:
-- you can't "refresh" cached content by using it again
-- cached content must appear in the exact same position to hit
-- any prefix changes invalidate the entire cache for that position
-
-## .cost.model
-
-### cache writes
-- **first use**: 25% of normal input token cost
-- **cache write**: happens on first occurrence of new content
-
-### cache reads
-- **cache hit**: 10% of normal input token cost
-- **cache miss**: 100% of normal input token cost (no cache benefit)
-
-### example: 30k token briefs
-- **first load**: ~7.5k tokens charged (25% write cost)
-- **subsequent hits**: ~3k tokens charged (10% read cost)
-- **cache miss**: 30k tokens charged (100% cost)
-
-## .sources
-- based on Anthropic's context caching documentation
-- observed behavior in production usage

package/dist/roles/designer/.briefs/declarative-over-imperative.md

@@ -1,79 +0,0 @@
-## 🎨 `.brief.designer.declarative-vs-imperative`
-
-### 🧠 topic: declarative vs. imperative design
-**why we prefer declarative design for building systems and interfaces**
-
----
-
-### 🎯 goal
-empower the designer to create systems that are **easier to understand, maintain, and scale**, by focusing on **what should happen**, not **how to do it**.
-
----
-
-### 🗺 core distinction
-
-| style           | imperative                               | declarative                                      |
-|-----------------|-------------------------------------------|--------------------------------------------------|
-| mindset         | tell the system *how* to do it            | tell the system *what* you want                 |
-| metaphor        | step-by-step instructions                 | a blueprint or desired outcome                  |
-| example (UI)    | manually update DOM on events             | declare a component tree (e.g. React)           |
-| example (infra) | run shell scripts to create servers       | declare infrastructure state (e.g. Terraform)   |
-
----
-
-### ✅ why declarative is better
-
-- **easier to read** — you see the structure and intent at a glance
-- **easier to write** — fewer details to manage = fewer bugs
-- **easier to maintain** — updates ripple automatically via system logic
-- **easier to scale** — declarative patterns are composable and predictable
-- **easier to debug** — the system owns the "how", so you debug at a higher level
-
----
-
-### 🛠 what it enables
-
-- **reusability** — components can be reused without re-specifying every step
-- **tooling & automation** — systems can analyze, optimize, or transform declarative specs
-- **flexibility** — changes in the underlying mechanics don’t require changing the design spec
-
----
-
-### ⚙️ trade-off to accept
-
-> declarative systems often need an **interpreter** — something that translates the high-level design into low-level instructions.
-
-this adds a little more **upfront work** —
-but it’s worth it, because:
-
-- it creates a **framework that abstracts away technical.domain details**
-- it keeps designers and builders focused on **behavioral.domain details**, where real value lives
-
----
-
-### 🧠 core belief
-
-> technical.domain work only adds value to developers, not to real people.
-
-- developer use is temporary → system builders
-- real folk use is forever → system engagers
-
-so we design declaratively —
-to serve people, not pipelines.
-
----
-
-### 💬 analogy
-
-> imperative = writing down GPS directions step by step
-> declarative = dropping a pin and letting the GPS figure it out
-
----
-
-### 🧩 final synthesis
-
-> declarative design keeps your focus on **what the user should experience**,
-> not on **how the system should behave step-by-step**.
-
-this keeps your mental model aligned with the human experience —
-not the machine’s internals.

package/dist/roles/designer/.briefs/declarative-over-imperative.stub.md

@@ -1,14 +0,0 @@
-todo: declare a brief that explains why we prefer to design systems w/ declarative instead of imperative
-
-e.g.,
-- easier to use
-- easier to read
-- easier to write
-- easier to maintain
-
-
-adds a little more upfront work in how to translate the declarations into imperative instructions, but its worth it, as that framework helps you abstract away the technical.domain details and keeps you in the behavioral.domain details instead, as desired
-
-remember: technical.domain work only adds value to developers, not to real people. we want to distribute value to real people
-- developer use is temporary -> system builders
-- real folk use is forever -> system engagers

package/dist/roles/designer/.briefs/pit-of-success.md

@@ -1,70 +0,0 @@
-## 🧠 `.brief.designer.pit-of-success`
-
-### 🧠 topic: the "pit of success"
-**why we design systems to naturally guide users toward the right outcome**
-
----
-
-### 🎯 goal
-build interfaces, flows, and defaults that make the **right path the easiest path** — where success isn’t just possible, it’s hard to miss.
-
----
-
-### 🕳 metaphor: pit of success
-
-> a system where users "fall into" the right outcome
-> — not by being perfect, but by following the path of least resistance.
-
-opposite of this is the **pit of despair**
-> where any slight move can throw you down into unexpected errors and wasted time.
-
----
-
-### ✅ why the "pit of success" matters
-
-- **reduces friction** — users don’t need deep understanding to get it right
-- **reduces support burden** — fewer errors, less need for rescue
-- **builds confidence** — users feel smart, not stupid
-- **supports scalability** — new users succeed without handholding
-- **encourages trust** — when success feels natural, users keep going
-
-> software should **make the right thing easy** and the wrong thing **hard or impossible**.
-
----
-
-### 🛠 tips to create it
-
-- **smart defaults** — sensible, safe choices pre-filled
-- **clear next steps** — obvious buttons, flows, and language
-- **constrained input** — prevent invalid states instead of reacting to them
-- **progressive disclosure** — complexity revealed only when needed
-- **stateful feedback** — show users what changed and why
-- **fail fast** — surface issues *immediately*, not after damage is done
-
----
-
-### 🧱 core design principle
-
-> success should be the **path of least resistance**
-> failure should require **active effort or deviation**
-
-we engineer **invisible safety rails**, not pop-up warning signs.
-
----
-
-### 🧠 behavioral insight
-
-users don’t read manuals — they feel their way forward.
-if success depends on correctness, users fail.
-if success depends on momentum, users win.
-
----
-
-### 🧩 final synthesis
-
-> software should **produce a pit of success** for the user:
-> the right path should feel obvious, safe, and rewarding —
-> and the wrong path should be hard to access or easy to recover from.
-
-design for **gravity** —
-so the system pulls people toward success, not traps them in failure.

package/dist/roles/designer/.briefs/pit-of-success.stub.md

@@ -1,3 +0,0 @@
-software should produce a pit-of-success for the user
-
-it should be hard to do the wrong thing

package/dist/roles/designer/getDesignerBrief.Options.codegen.d.ts

@@ -1,10 +0,0 @@
-/**
- * .what = the options for the briefs available to role Designer
- * .note = codegened via:
- * ```sh
- *  npx tsx src/contract/commands/codegenBriefOptions.ts
- * ```
- */
-declare const options: readonly ["declarative-over-imperative.md", "pit-of-success.md"];
-export type BriefOptionDesigner = (typeof options)[number];
-export {};

package/dist/roles/designer/getDesignerBrief.Options.codegen.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * .what = the options for the briefs available to role Designer
- * .note = codegened via:
- * ```sh
- *  npx tsx src/contract/commands/codegenBriefOptions.ts
- * ```
- */
-const options = [
-    'declarative-over-imperative.md',
-    'pit-of-success.md',
-];
-//# sourceMappingURL=getDesignerBrief.Options.codegen.js.map

package/dist/roles/designer/getDesignerBrief.Options.codegen.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"getDesignerBrief.Options.codegen.js","sourceRoot":"","sources":["../../../src/roles/designer/getDesignerBrief.Options.codegen.ts"],"names":[],"mappings":";;AAAA;;;;;;GAMG;AACH,MAAM,OAAO,GAAG;IACd,gCAAgC;IAChC,mBAAmB;CACX,CAAC"}

package/dist/roles/designer/getDesignerBrief.d.ts

@@ -1,13 +0,0 @@
-import type { Artifact } from 'rhachet-artifact';
-import { type GitFile } from 'rhachet-artifact-git';
-import type { BriefOptionDesigner } from './getDesignerBrief.Options.codegen';
-/**
- * .what = loads an artifact:brief distilled for the mechanic to reference, from the `.briefs` directory
- * .why = enables reusable knowledge downloads for mechanic contexts (e.g., matrix-movie style)
- */
-export declare const getDesignerBrief: (key: BriefOptionDesigner) => Artifact<typeof GitFile>;
-/**
- * .what = loads multiple artifact:brief distilled for the mechanic to reference, from the `.briefs` directory
- * .why = enables reusable knowledge downloads for mechanic contexts (e.g., matrix-movie style)
- */
-export declare const getDesignerBriefs: (keys: BriefOptionDesigner[]) => Artifact<typeof GitFile>[];

package/dist/roles/designer/getDesignerBrief.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDesignerBriefs = exports.getDesignerBrief = void 0;
-const rhachet_artifact_git_1 = require("rhachet-artifact-git");
-/**
- * .what = loads an artifact:brief distilled for the mechanic to reference, from the `.briefs` directory
- * .why = enables reusable knowledge downloads for mechanic contexts (e.g., matrix-movie style)
- */
-const getDesignerBrief = (key) => {
-    return (0, rhachet_artifact_git_1.genArtifactGitFile)({
-        uri: `${__dirname}/.briefs/${key}`,
-    });
-};
-exports.getDesignerBrief = getDesignerBrief;
-/**
- * .what = loads multiple artifact:brief distilled for the mechanic to reference, from the `.briefs` directory
- * .why = enables reusable knowledge downloads for mechanic contexts (e.g., matrix-movie style)
- */
-const getDesignerBriefs = (keys) => keys.map(exports.getDesignerBrief);
-exports.getDesignerBriefs = getDesignerBriefs;
-//# sourceMappingURL=getDesignerBrief.js.map

package/dist/roles/designer/getDesignerBrief.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"getDesignerBrief.js","sourceRoot":"","sources":["../../../src/roles/designer/getDesignerBrief.ts"],"names":[],"mappings":";;;AACA,+DAAwE;AAIxE;;;GAGG;AACI,MAAM,gBAAgB,GAAG,CAC9B,GAAwB,EACE,EAAE;IAC5B,OAAO,IAAA,yCAAkB,EAAC;QACxB,GAAG,EAAE,GAAG,SAAS,YAAY,GAAG,EAAE;KACnC,CAAC,CAAC;AACL,CAAC,CAAC;AANW,QAAA,gBAAgB,oBAM3B;AAEF;;;GAGG;AACI,MAAM,iBAAiB,GAAG,CAC/B,IAA2B,EACC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,wBAAgB,CAAC,CAAC;AAF/C,QAAA,iBAAiB,qBAE8B"}

package/dist/roles/designer/outlineDistilisys/loopOutlineDistilisys.d.ts

@@ -1,26 +0,0 @@
-import { type GStitcher, type RoleContext, type Threads } from 'rhachet';
-import type { Artifact } from 'rhachet-artifact';
-import type { GitFile } from 'rhachet-artifact-git';
-import type { ContextOpenAI } from '../../../access/sdk/sdkOpenAi';
-type StitcherDesired = GStitcher<Threads<{
-    designer: RoleContext<'designer', {
-        art: {
-            roadmap: Artifact<typeof GitFile>;
-            distilisys: Artifact<typeof GitFile>;
-        };
-    }>;
-    caller: RoleContext<'caller', {
-        ask: string;
-        art: {
-            feedback: Artifact<typeof GitFile>;
-        };
-    }>;
-}>, ContextOpenAI & GStitcher['context'], {
-    content: string;
-}>;
-/**
- * .what = loop until caller confirms no more notes
- * todo: generalize this loop wrapper onto any stitcher
- */
-export declare const loopOutlineDistilisys: import("rhachet").Stitcher<StitcherDesired>;
-export {};