rhachet-brains-openai 0.2.0 → 0.2.1

package/dist/domain.operations/atoms/genBrainAtom.d.ts

@@ -1,4 +1,4 @@
-import { BrainAtom } from 'rhachet';
+import { BrainAtom } from 'rhachet/brains';
 import { type OpenaiBrainAtomSlug } from '../../domain.objects/BrainAtom.config';
 /**
  * .what = factory to generate openai brain atom instances

package/dist/domain.operations/repls/genBrainRepl.d.ts

@@ -1,4 +1,4 @@
-import { BrainRepl } from 'rhachet';
+import { BrainRepl } from 'rhachet/brains';
 /**
  * .what = supported openai brain repl slugs
  * .why = enables type-safe slug specification with model variants

package/dist/index.js

@@ -39,8 +39,7 @@ module.exports = __toCommonJS(index_exports);
 
 // src/domain.operations/atoms/genBrainAtom.ts
 var import_openai = __toESM(require("openai"));
-var import_rhachet = require("rhachet");
-var import_calcBrainOutputCost = require("rhachet/dist/domain.operations/brainCost/calcBrainOutputCost");
+var import_brains = require("rhachet/brains");
 var import_zod = require("zod");
 
 // src/domain.objects/BrainAtom.config.ts
@@ -806,7 +805,7 @@ var CONFIG_BY_ATOM_SLUG = {
 // src/domain.operations/atoms/genBrainAtom.ts
 var genBrainAtom = (input) => {
   const config = CONFIG_BY_ATOM_SLUG[input.slug];
-  return new import_rhachet.BrainAtom({
+  return new import_brains.BrainAtom({
     repo: "openai",
     slug: input.slug,
     description: config.description,
@@ -817,7 +816,7 @@ var genBrainAtom = (input) => {
      */
     ask: async (askInput, context) => {
       const startTime = Date.now();
-      const systemPrompt = askInput.role.briefs ? await (0, import_rhachet.castBriefsToPrompt)({ briefs: askInput.role.briefs }) : void 0;
+      const systemPrompt = askInput.role.briefs ? await (0, import_brains.castBriefsToPrompt)({ briefs: askInput.role.briefs }) : void 0;
       const openai = context?.openai ?? new import_openai.default({ apiKey: process.env.OPENAI_API_KEY });
       const jsonSchema = import_zod.z.toJSONSchema(askInput.schema.output);
       const isObjectSchema = typeof jsonSchema === "object" && jsonSchema !== null && "type" in jsonSchema && jsonSchema.type === "object";
@@ -826,9 +825,17 @@ var genBrainAtom = (input) => {
 ---
 
 ${askInput.prompt}` : askInput.prompt;
+      const priorMessages = askInput.on?.episode?.exchanges.flatMap((exchange) => [
+        { role: "user", content: exchange.input },
+        { role: "assistant", content: exchange.output }
+      ]) ?? [];
+      const inputMessages = [
+        ...priorMessages,
+        { role: "user", content: fullPrompt }
+      ];
       const response = await openai.responses.create({
         model: config.model,
-        input: fullPrompt,
+        input: inputMessages,
         ...isObjectSchema && {
           text: {
             format: {
@@ -863,11 +870,11 @@ ${askInput.prompt}` : askInput.prompt;
           cache: { get: 0, set: 0 }
         }
       };
-      const { cash } = (0, import_calcBrainOutputCost.calcBrainOutputCost)({
+      const { cash } = (0, import_brains.calcBrainOutputCost)({
         for: { tokens: size.tokens },
         with: { cost: { cash: config.spec.cost.cash } }
       });
-      const metrics = new import_rhachet.BrainOutputMetrics({
+      const metrics = new import_brains.BrainOutputMetrics({
         size,
         cost: {
           time: { milliseconds: elapsedMs },
@@ -875,7 +882,26 @@ ${askInput.prompt}` : askInput.prompt;
         }
       });
       const output = isObjectSchema ? askInput.schema.output.parse(JSON.parse(content)) : askInput.schema.output.parse(content);
-      return new import_rhachet.BrainOutput({ output, metrics });
+      const continuables = await (0, import_brains.genBrainContinuables)({
+        for: { grain: "atom" },
+        on: {
+          episode: askInput.on?.episode ?? null,
+          series: null
+        },
+        with: {
+          exchange: {
+            input: askInput.prompt,
+            output: content,
+            exid: response.id
+          }
+        }
+      });
+      return new import_brains.BrainOutput({
+        output,
+        metrics,
+        episode: continuables.episode,
+        series: continuables.series
+      });
     }
   });
 };
@@ -1235,8 +1261,8 @@ var Codex = class {
 };
 
 // src/domain.operations/repls/genBrainRepl.ts
-var import_rhachet2 = require("rhachet");
-var import_calcBrainOutputCost2 = require("rhachet/dist/domain.operations/brainCost/calcBrainOutputCost");
+var import_helpful_errors = require("helpful-errors");
+var import_brains2 = require("rhachet/brains");
 var import_wrapper_fns = require("wrapper-fns");
 
 // src/infra/schema/asJsonSchema.ts
@@ -1267,9 +1293,17 @@ var composePromptWithSystem = (userPrompt, systemPrompt) => {
 
 ${userPrompt}`;
 };
+var EXID_PREFIX = "openai/codex";
+var encodeExid = (threadId) => `${EXID_PREFIX}/${threadId}`;
+var decodeExid = (exid) => {
+  if (!exid.startsWith(`${EXID_PREFIX}/`)) return { valid: false };
+  const threadId = exid.slice(`${EXID_PREFIX}/`.length);
+  if (!threadId) return { valid: false };
+  return { valid: true, threadId };
+};
 var invokeCodex = async (input) => {
   const startTime = Date.now();
-  const systemPrompt = input.role.briefs ? await (0, import_rhachet2.castBriefsToPrompt)({ briefs: input.role.briefs }) : void 0;
+  const systemPrompt = input.role.briefs ? await (0, import_brains2.castBriefsToPrompt)({ briefs: input.role.briefs }) : void 0;
   const outputSchema = asJsonSchema({
     schema: input.schema.output
   });
@@ -1277,10 +1311,18 @@ var invokeCodex = async (input) => {
     apiKey: process.env.OPENAI_API_KEY
   });
   const sandboxMode = input.mode === "ask" ? "read-only" : "workspace-write";
-  const thread = codex.startThread({
-    model: input.model,
-    sandboxMode
-  });
+  const threadOptions = { model: input.model, sandboxMode };
+  const priorExid = input.on?.episode?.exid ?? null;
+  const thread = (() => {
+    if (!priorExid) return codex.startThread(threadOptions);
+    const decoded = decodeExid(priorExid);
+    if (!decoded.valid)
+      throw new import_helpful_errors.BadRequestError(
+        "episode continuation failed: exid is not from openai/codex. cross-supplier continuation is not supported.",
+        { priorExid }
+      );
+    return codex.resumeThread(decoded.threadId, threadOptions);
+  })();
   const fullPrompt = composePromptWithSystem(input.prompt, systemPrompt);
   const response = await (0, import_wrapper_fns.withRetry)(
     (0, import_wrapper_fns.withTimeout)(async () => thread.run(fullPrompt, { outputSchema }), {
@@ -1313,22 +1355,43 @@ var invokeCodex = async (input) => {
       cache: { get: 0, set: 0 }
     }
   };
-  const { cash } = (0, import_calcBrainOutputCost2.calcBrainOutputCost)({
+  const { cash } = (0, import_brains2.calcBrainOutputCost)({
     for: { tokens: size.tokens },
     with: { cost: { cash: input.spec.cost.cash } }
   });
-  const metrics = new import_rhachet2.BrainOutputMetrics({
+  const metrics = new import_brains2.BrainOutputMetrics({
     size,
     cost: {
       time: { milliseconds: elapsedMs },
       cash
     }
   });
-  return new import_rhachet2.BrainOutput({ output, metrics });
+  const threadExid = thread.id ? encodeExid(thread.id) : null;
+  const continuables = await (0, import_brains2.genBrainContinuables)({
+    for: { grain: "repl" },
+    on: {
+      episode: input.on?.episode ?? null,
+      series: input.on?.series ?? null
+    },
+    with: {
+      exchange: {
+        input: input.prompt,
+        output: content,
+        exid: thread.id
+      },
+      episode: { exid: threadExid }
+    }
+  });
+  return new import_brains2.BrainOutput({
+    output,
+    metrics,
+    episode: continuables.episode,
+    series: continuables.series
+  });
 };
 var genBrainRepl = (input) => {
   const config = CONFIG_BY_REPL_SLUG[input.slug];
-  return new import_rhachet2.BrainRepl({
+  return new import_brains2.BrainRepl({
     repo: "openai",
     slug: input.slug,
     description: config.description,
@@ -1341,7 +1404,11 @@ var genBrainRepl = (input) => {
       mode: "ask",
       model: config.model,
       spec: config.spec,
-      ...askInput
+      on: askInput.on,
+      plugs: askInput.plugs,
+      role: askInput.role,
+      prompt: askInput.prompt,
+      schema: askInput.schema
     }),
     /**
      * .what = read+write actions (code changes, file edits)
@@ -1351,7 +1418,11 @@ var genBrainRepl = (input) => {
       mode: "act",
       model: config.model,
       spec: config.spec,
-      ...actInput
+      on: actInput.on,
+      plugs: actInput.plugs,
+      role: actInput.role,
+      prompt: actInput.prompt,
+      schema: actInput.schema
     })
   });
 };

package/package.json

@@ -2,7 +2,7 @@
   "name": "rhachet-brains-openai",
   "author": "ehmpathy",
   "description": "rhachet brain.atom and brain.repl adapter for openai",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "repository": "ehmpathy/rhachet-brains-openai",
   "homepage": "https://github.com/ehmpathy/rhachet-brains-openai",
   "keywords": [
@@ -54,7 +54,7 @@
     "preversion": "npm run prepush",
     "postversion": "git push origin HEAD --tags --no-verify",
     "prepare:husky": "husky install && chmod ug+x .husky/*",
-    "prepare:rhachet": "rhachet init --mode upsert && rhachet roles link --repo ehmpathy --role mechanic && rhachet roles link --repo bhuild --role behaver && rhachet roles link --repo bhrain --role reviewer && rhachet roles init --role mechanic && rhachet roles init --role behaver",
+    "prepare:rhachet": "rhachet init --hooks --roles behaver mechanic reviewer",
     "prepare": "if [ -e .git ] && [ -z $CI ]; then npm run prepare:husky && npm run prepare:rhachet; fi"
   },
   "dependencies": {
@@ -90,10 +90,11 @@
     "husky": "8.0.3",
     "iso-time": "1.11.1",
     "jest": "30.2.0",
-    "rhachet": "1.26.0",
-    "rhachet-roles-bhrain": "0.5.9",
-    "rhachet-roles-bhuild": "0.6.3",
-    "rhachet-roles-ehmpathy": "1.17.15",
+    "rhachet": "1.29.5",
+    "rhachet-brains-anthropic": "0.3.2",
+    "rhachet-roles-bhrain": "0.7.5",
+    "rhachet-roles-bhuild": "0.7.0",
+    "rhachet-roles-ehmpathy": "1.18.0",
     "test-fns": "1.10.0",
     "tsc-alias": "1.8.10",
     "tsx": "4.20.6",

package/readme.md

@@ -51,6 +51,60 @@ const { output: { proposal } } = await brainRepl.act({
 });
 ```
 
+## continuation support
+
+both atoms and repls support multi-turn conversations via episode continuation.
+
+### atoms
+
+atoms support continuation via the openai responses api. pass the prior episode to continue the conversation:
+
+```ts
+// first call establishes context
+const resultFirst = await brainAtom.ask({
+  role: {},
+  prompt: 'remember the secret word "PINEAPPLE42"',
+  schema: { output: z.object({ content: z.string() }) },
+});
+
+// second call continues with prior context
+const resultSecond = await brainAtom.ask({
+  on: { episode: resultFirst.episode },
+  role: {},
+  prompt: 'what is the secret word I told you?',
+  schema: { output: z.object({ content: z.string() }) },
+});
+// resultSecond.output.content contains "PINEAPPLE42"
+```
+
+### repls
+
+repls support continuation via the codex-sdk `resumeThread()` api. the episode exid contains the thread id prefixed with `openai/codex/` for cross-supplier validation:
+
+```ts
+// first call starts a new thread
+const resultFirst = await brainRepl.ask({
+  role: {},
+  prompt: 'remember the secret word "MANGO99"',
+  schema: { output: z.object({ content: z.string() }) },
+});
+// resultFirst.episode.exid = "openai/codex/{threadId}"
+
+// second call resumes the thread
+const resultSecond = await brainRepl.ask({
+  on: { episode: resultFirst.episode },
+  role: {},
+  prompt: 'what is the secret word I told you?',
+  schema: { output: z.object({ content: z.string() }) },
+});
+// resultSecond.output.content contains "MANGO99"
+```
+
+### limitations
+
+- **cross-supplier continuation is not supported**: episodes from other brain suppliers (e.g., anthropic) cannot be used to continue openai conversations. this throws a `BadRequestError`.
+- **exid validation**: the episode exid must start with `openai/codex/` for repl continuation. this prevents accidental cross-supplier continuation attempts.
+
 ## available brains
 
 ### atoms (via genBrainAtom)