rhachet-brains-openai 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Uladzimir Kasacheuski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/contract/sdk/index.d.ts

@@ -0,0 +1,13 @@
+import type { BrainAtom, BrainRepl } from 'rhachet';
+/**
+ * .what = returns all brain atoms provided by openai
+ * .why = enables consumers to register openai atoms with genContextBrain
+ */
+export declare const getBrainAtomsByOpenAI: () => BrainAtom[];
+/**
+ * .what = returns all brain repls provided by openai
+ * .why = enables consumers to register openai repls with genContextBrain
+ */
+export declare const getBrainReplsByOpenAI: () => BrainRepl[];
+export { genBrainAtom } from '../../domain.operations/atoms/genBrainAtom';
+export { genBrainRepl } from '../../domain.operations/repls/genBrainRepl';

package/dist/contract/sdk/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genBrainRepl = exports.genBrainAtom = exports.getBrainReplsByOpenAI = exports.getBrainAtomsByOpenAI = void 0;
+const genBrainAtom_1 = require("../../domain.operations/atoms/genBrainAtom");
+const genBrainRepl_1 = require("../../domain.operations/repls/genBrainRepl");
+/**
+ * .what = returns all brain atoms provided by openai
+ * .why = enables consumers to register openai atoms with genContextBrain
+ */
+const getBrainAtomsByOpenAI = () => {
+    return [(0, genBrainAtom_1.genBrainAtom)({ slug: 'openai/gpt-4o' })];
+};
+exports.getBrainAtomsByOpenAI = getBrainAtomsByOpenAI;
+/**
+ * .what = returns all brain repls provided by openai
+ * .why = enables consumers to register openai repls with genContextBrain
+ */
+const getBrainReplsByOpenAI = () => {
+    return [(0, genBrainRepl_1.genBrainRepl)({ slug: 'openai/codex' })];
+};
+exports.getBrainReplsByOpenAI = getBrainReplsByOpenAI;
+// re-export factories for direct access
+var genBrainAtom_2 = require("../../domain.operations/atoms/genBrainAtom");
+Object.defineProperty(exports, "genBrainAtom", { enumerable: true, get: function () { return genBrainAtom_2.genBrainAtom; } });
+var genBrainRepl_2 = require("../../domain.operations/repls/genBrainRepl");
+Object.defineProperty(exports, "genBrainRepl", { enumerable: true, get: function () { return genBrainRepl_2.genBrainRepl; } });
+//# sourceMappingURL=index.js.map

package/dist/contract/sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contract/sdk/index.ts"],"names":[],"mappings":";;;AAEA,6EAA0E;AAC1E,6EAA0E;AAE1E;;;GAGG;AACI,MAAM,qBAAqB,GAAG,GAAgB,EAAE;IACrD,OAAO,CAAC,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC,CAAC;AAFW,QAAA,qBAAqB,yBAEhC;AAEF;;;GAGG;AACI,MAAM,qBAAqB,GAAG,GAAgB,EAAE;IACrD,OAAO,CAAC,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;AAClD,CAAC,CAAC;AAFW,QAAA,qBAAqB,yBAEhC;AAEF,wCAAwC;AACxC,2EAA0E;AAAjE,4GAAA,YAAY,OAAA;AACrB,2EAA0E;AAAjE,4GAAA,YAAY,OAAA"}

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

@@ -0,0 +1,19 @@
+import { type BrainAtom } from 'rhachet';
+/**
+ * .what = supported openai atom slugs
+ * .why = enables type-safe slug specification with model variants
+ */
+type OpenAIAtomSlug = 'openai/gpt-4o' | 'openai/gpt-4o-mini' | 'openai/gpt-4-turbo' | 'openai/o1' | 'openai/o1-mini' | 'openai/o1-preview';
+/**
+ * .what = factory to generate openai brain atom instances
+ * .why = enables model variant selection via slug
+ *
+ * .example
+ *   genBrainAtom({ slug: 'openai/gpt-4o' })
+ *   genBrainAtom({ slug: 'openai/gpt-4o-mini' }) // fast + cheap
+ *   genBrainAtom({ slug: 'openai/o1' }) // advanced reasoning
+ */
+export declare const genBrainAtom: (input: {
+    slug: OpenAIAtomSlug;
+}) => BrainAtom;
+export {};

package/dist/domain.operations/atoms/genBrainAtom.js

@@ -0,0 +1,97 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genBrainAtom = void 0;
+const openai_1 = __importDefault(require("openai"));
+const rhachet_1 = require("rhachet");
+const zod_1 = require("zod");
+/**
+ * .what = model configuration by slug
+ * .why = maps slugs to API model names and descriptions
+ */
+const CONFIG_BY_SLUG = {
+    'openai/gpt-4o': {
+        model: 'gpt-4o',
+        description: 'gpt-4o - multimodal model for reasoning and vision',
+    },
+    'openai/gpt-4o-mini': {
+        model: 'gpt-4o-mini',
+        description: 'gpt-4o-mini - fast and cost-effective multimodal model',
+    },
+    'openai/gpt-4-turbo': {
+        model: 'gpt-4-turbo',
+        description: 'gpt-4-turbo - high capability with vision support',
+    },
+    'openai/o1': {
+        model: 'o1',
+        description: 'o1 - advanced reasoning model for complex problems',
+    },
+    'openai/o1-mini': {
+        model: 'o1-mini',
+        description: 'o1-mini - fast reasoning model for coding and math',
+    },
+    'openai/o1-preview': {
+        model: 'o1-preview',
+        description: 'o1-preview - preview of advanced reasoning capabilities',
+    },
+};
+/**
+ * .what = factory to generate openai brain atom instances
+ * .why = enables model variant selection via slug
+ *
+ * .example
+ *   genBrainAtom({ slug: 'openai/gpt-4o' })
+ *   genBrainAtom({ slug: 'openai/gpt-4o-mini' }) // fast + cheap
+ *   genBrainAtom({ slug: 'openai/o1' }) // advanced reasoning
+ */
+const genBrainAtom = (input) => {
+    const config = CONFIG_BY_SLUG[input.slug];
+    return {
+        repo: 'openai',
+        slug: input.slug,
+        description: config.description,
+        /**
+         * .what = stateless inference (no tool use)
+         * .why = provides direct model access for reasoning tasks
+         */
+        ask: async (askInput, context) => {
+            // compose system prompt from briefs
+            const systemPrompt = askInput.role.briefs
+                ? await (0, rhachet_1.castBriefsToPrompt)({ briefs: askInput.role.briefs })
+                : undefined;
+            // get openai client from context or create new one
+            const openai = context?.openai ??
+                new openai_1.default({ apiKey: process.env.OPENAI_API_KEY });
+            // build messages array
+            const messages = [];
+            if (systemPrompt) {
+                messages.push({ role: 'system', content: systemPrompt });
+            }
+            messages.push({ role: 'user', content: askInput.prompt });
+            // convert zod schema to json schema for structured output
+            const jsonSchema = zod_1.z.toJSONSchema(askInput.schema.output);
+            // call openai api with strict json_schema response format
+            const response = await openai.chat.completions.create({
+                model: config.model,
+                messages,
+                response_format: {
+                    type: 'json_schema',
+                    json_schema: {
+                        name: 'response',
+                        strict: true,
+                        schema: jsonSchema,
+                    },
+                },
+            });
+            // extract content from response
+            const content = response.choices[0]?.message?.content ?? '';
+            // parse JSON response and validate via schema
+            const parsed = JSON.parse(content);
+            return askInput.schema.output.parse(parsed);
+        },
+    };
+};
+exports.genBrainAtom = genBrainAtom;
+//# sourceMappingURL=genBrainAtom.js.map

package/dist/domain.operations/atoms/genBrainAtom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genBrainAtom.js","sourceRoot":"","sources":["../../../src/domain.operations/atoms/genBrainAtom.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAC5B,qCAA6D;AAI7D,6BAAwB;AAcxB;;;GAGG;AACH,MAAM,cAAc,GAGhB;IACF,eAAe,EAAE;QACf,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,oDAAoD;KAClE;IACD,oBAAoB,EAAE;QACpB,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,wDAAwD;KACtE;IACD,oBAAoB,EAAE;QACpB,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,mDAAmD;KACjE;IACD,WAAW,EAAE;QACX,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,oDAAoD;KAClE;IACD,gBAAgB,EAAE;QAChB,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,oDAAoD;KAClE;IACD,mBAAmB,EAAE;QACnB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,yDAAyD;KACvE;CACF,CAAC;AAEF;;;;;;;;GAQG;AACI,MAAM,YAAY,GAAG,CAAC,KAA+B,EAAa,EAAE;IACzE,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE1C,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,MAAM,CAAC,WAAW;QAE/B;;;WAGG;QACH,GAAG,EAAE,KAAK,EACR,QAIC,EACD,OAAe,EACG,EAAE;YACpB,oCAAoC;YACpC,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM;gBACvC,CAAC,CAAC,MAAM,IAAA,4BAAkB,EAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC5D,CAAC,CAAC,SAAS,CAAC;YAEd,mDAAmD;YACnD,MAAM,MAAM,GACT,OAAO,EAAE,MAA6B;gBACvC,IAAI,gBAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC;YAErD,uBAAuB;YACvB,MAAM,QAAQ,GAAwC,EAAE,CAAC;YACzD,IAAI,YAAY,EAAE,CAAC;gBACjB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAE1D,0DAA0D;YAC1D,MAAM,UAAU,GAAG,OAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAE1D,0DAA0D;YAC1D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;gBACpD,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,QAAQ;gBACR,eAAe,EAAE;oBACf,IAAI,EAAE,aAAa;oBACnB,WAAW,EAAE;wBACX,IAAI,EAAE,UAAU;wBAChB,MAAM,EAAE,IAAI;wBACZ,MAAM,EAAE,UAAU;qBACnB;iBACF;aACF,CAAC,CAAC;YAEH,gCAAgC;YAChC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;YAE5D,8CAA8C;YAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,OAAO,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AA9DW,QAAA,YAAY,gBA8DvB"}

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

@@ -0,0 +1,19 @@
+import { BrainRepl } from 'rhachet';
+/**
+ * .what = supported openai codex repl slugs
+ * .why = enables type-safe slug specification with model variants
+ */
+type CodexSlug = 'openai/codex' | 'openai/codex/max' | 'openai/codex/mini' | 'openai/codex/5.2';
+/**
+ * .what = factory to generate openai codex brain repl instances
+ * .why = enables model variant selection via slug
+ *
+ * .example
+ *   genBrainRepl({ slug: 'openai/codex' }) // default model
+ *   genBrainRepl({ slug: 'openai/codex/mini' }) // fast + cheap
+ *   genBrainRepl({ slug: 'openai/codex/5.2' }) // most advanced
+ */
+export declare const genBrainRepl: (input: {
+    slug: CodexSlug;
+}) => BrainRepl;
+export {};

package/dist/domain.operations/repls/genBrainRepl.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genBrainRepl = void 0;
+const codex_sdk_1 = require("@openai/codex-sdk");
+const rhachet_1 = require("rhachet");
+const wrapper_fns_1 = require("wrapper-fns");
+const asJsonSchema_1 = require("../../infra/schema/asJsonSchema");
+/**
+ * .what = model configuration by slug
+ * .why = maps slugs to API model names and descriptions
+ */
+const CONFIG_BY_SLUG = {
+    'openai/codex': {
+        model: undefined, // use SDK default (gpt-5.1-codex-max)
+        description: 'codex - agentic coding assistant (default model)',
+    },
+    'openai/codex/max': {
+        model: 'gpt-5.1-codex-max',
+        description: 'codex max - optimized for long-horizon agentic coding',
+    },
+    'openai/codex/mini': {
+        model: 'gpt-5.1-codex-mini',
+        description: 'codex mini - fast and cost-effective',
+    },
+    'openai/codex/5.2': {
+        model: 'gpt-5.2-codex',
+        description: 'codex 5.2 - most advanced agentic coding model',
+    },
+};
+/**
+ * .what = composes full prompt with optional system context
+ * .why = codex-sdk ThreadOptions doesn't have systemPrompt, must prepend to user prompt
+ */
+const composePromptWithSystem = (userPrompt, systemPrompt) => {
+    if (!systemPrompt)
+        return userPrompt;
+    return `${systemPrompt}\n\n---\n\n${userPrompt}`;
+};
+/**
+ * .what = invokes codex sdk with specified sandbox mode
+ * .why = dedupes shared logic between ask (read-only) and act (workspace-write)
+ */
+const invokeCodex = async (input) => {
+    // compose system prompt from briefs
+    const systemPrompt = input.role.briefs
+        ? await (0, rhachet_1.castBriefsToPrompt)({ briefs: input.role.briefs })
+        : undefined;
+    // convert zod schema to json schema for native enforcement
+    const outputSchema = (0, asJsonSchema_1.asJsonSchema)({
+        schema: input.schema.output,
+    });
+    // create codex client
+    const codex = new codex_sdk_1.Codex({
+        apiKey: process.env.OPENAI_API_KEY,
+    });
+    // start thread with sandbox mode based on operation type
+    const sandboxMode = input.mode === 'ask' ? 'read-only' : 'workspace-write';
+    const thread = codex.startThread({
+        model: input.model,
+        sandboxMode,
+    });
+    // compose full prompt and run with timeout + retry for resilience
+    const fullPrompt = composePromptWithSystem(input.prompt, systemPrompt);
+    const response = await (0, wrapper_fns_1.withRetry)((0, wrapper_fns_1.withTimeout)(async () => thread.run(fullPrompt, { outputSchema }), {
+        threshold: { seconds: 60 },
+    }))();
+    // parse output via schema for runtime validation
+    return input.schema.output.parse(JSON.parse(response.finalResponse));
+};
+/**
+ * .what = factory to generate openai codex brain repl instances
+ * .why = enables model variant selection via slug
+ *
+ * .example
+ *   genBrainRepl({ slug: 'openai/codex' }) // default model
+ *   genBrainRepl({ slug: 'openai/codex/mini' }) // fast + cheap
+ *   genBrainRepl({ slug: 'openai/codex/5.2' }) // most advanced
+ */
+const genBrainRepl = (input) => {
+    const config = CONFIG_BY_SLUG[input.slug];
+    // extract model slug without the repo prefix (e.g., 'openai/codex' -> 'codex')
+    const modelSlug = input.slug.replace(/^openai\//, '');
+    return new rhachet_1.BrainRepl({
+        repo: 'openai',
+        slug: modelSlug,
+        description: config.description,
+        /**
+         * .what = readonly analysis (research, queries, code review)
+         * .why = provides safe, non-mutating agent interactions via read-only sandbox
+         */
+        ask: async (askInput, _context) => invokeCodex({ mode: 'ask', model: config.model, ...askInput }),
+        /**
+         * .what = read+write actions (code changes, file edits)
+         * .why = provides full agentic capabilities via workspace-write sandbox
+         */
+        act: async (actInput, _context) => invokeCodex({ mode: 'act', model: config.model, ...actInput }),
+    });
+};
+exports.genBrainRepl = genBrainRepl;
+//# sourceMappingURL=genBrainRepl.js.map

package/dist/domain.operations/repls/genBrainRepl.js.map

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

package/dist/infra/schema/asJsonSchema.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+/**
+ * .what = convert a zod schema to JSON schema for native SDK enforcement
+ * .why = enables native structured output support in SDKs, reducing
+ *   token waste on validation retries
+ *
+ * .note = different SDKs require different conversion options:
+ *   - claude-agent-sdk: { $refStrategy: 'root' }
+ *   - codex-sdk: { target: 'openAi' }
+ */
+export declare const asJsonSchema: (input: {
+    schema: z.ZodSchema;
+}) => object;

package/dist/infra/schema/asJsonSchema.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asJsonSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * .what = convert a zod schema to JSON schema for native SDK enforcement
+ * .why = enables native structured output support in SDKs, reducing
+ *   token waste on validation retries
+ *
+ * .note = different SDKs require different conversion options:
+ *   - claude-agent-sdk: { $refStrategy: 'root' }
+ *   - codex-sdk: { target: 'openAi' }
+ */
+const asJsonSchema = (input) => {
+    return zod_1.z.toJSONSchema(input.schema, { target: 'openAi' });
+};
+exports.asJsonSchema = asJsonSchema;
+//# sourceMappingURL=asJsonSchema.js.map

package/dist/infra/schema/asJsonSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asJsonSchema.js","sourceRoot":"","sources":["../../../src/infra/schema/asJsonSchema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;;;;;;;GAQG;AACI,MAAM,YAAY,GAAG,CAAC,KAA8B,EAAU,EAAE;IACrE,OAAO,OAAC,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC5D,CAAC,CAAC;AAFW,QAAA,YAAY,gBAEvB"}

package/license.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 ehmpathy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "rhachet-brains-openai",
+  "author": "ehmpathy",
+  "description": "rhachet BrainAtom & BrainRepl contracts for openai inference",
+  "version": "0.0.0",
+  "repository": "ehmpathy/rhachet-brains-openai",
+  "homepage": "https://github.com/ehmpathy/rhachet-brains-openai",
+  "keywords": [
+    "artifact",
+    "git",
+    "file",
+    "repo"
+  ],
+  "bugs": "https://github.com/ehmpathy/rhachet-brains-openai/issues",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "engines": {
+    "node": ">=8.0.0"
+  },
+  "files": [
+    "/dist"
+  ],
+  "dependencies": {
+    "@ehmpathy/uni-time": "1.8.1",
+    "@openai/codex-sdk": "0.77.0",
+    "as-procedure": "1.1.7",
+    "domain-objects": "0.31.9",
+    "find-up": "5.0.0",
+    "hash-fns": "1.1.0",
+    "helpful-errors": "1.5.3",
+    "openai": "5.8.2",
+    "rhachet-artifact": "1.0.1",
+    "rhachet-artifact-git": "1.1.5",
+    "serde-fns": "1.3.0",
+    "type-fns": "1.21.0",
+    "wrapper-fns": "1.1.7",
+    "zod": "4.3.4"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.8",
+    "@commitlint/cli": "19.5.0",
+    "@commitlint/config-conventional": "19.5.0",
+    "@swc/core": "1.15.3",
+    "@swc/jest": "0.2.39",
+    "@tsconfig/node20": "20.1.5",
+    "@tsconfig/strictest": "2.0.5",
+    "@types/jest": "30.0.0",
+    "@types/node": "22.15.21",
+    "cz-conventional-changelog": "3.3.0",
+    "declapract": "0.13.14",
+    "declapract-typescript-ehmpathy": "0.47.16",
+    "declastruct": "1.7.3",
+    "declastruct-github": "1.3.0",
+    "depcheck": "1.4.3",
+    "esbuild-register": "3.6.0",
+    "husky": "8.0.3",
+    "jest": "30.2.0",
+    "rhachet": "1.21.4",
+    "rhachet-roles-bhrain": "0.5.9",
+    "rhachet-roles-bhuild": "0.6.3",
+    "rhachet-roles-ehmpathy": "1.17.15",
+    "test-fns": "1.5.0",
+    "tsc-alias": "1.8.10",
+    "tsx": "4.20.6",
+    "typescript": "5.4.5",
+    "yalc": "1.0.0-pre.53"
+  },
+  "config": {
+    "commitizen": {
+      "path": "./node_modules/cz-conventional-changelog"
+    }
+  },
+  "scripts": {
+    "build:ts": "tsc -p ./tsconfig.build.json",
+    "commit:with-cli": "npx cz",
+    "fix:format:biome": "biome check --write",
+    "fix:format": "npm run fix:format:biome",
+    "fix:lint": "biome check --write",
+    "fix": "npm run fix:format && npm run fix:lint",
+    "build:clean:bun": "rm -f ./bin/*.bc",
+    "build:clean:tsc": "(chmod -R u+w dist 2>/dev/null || true) && rm -rf dist/",
+    "build:clean": "npm run build:clean:tsc && npm run build:clean:bun",
+    "build:compile:tsc": "tsc -p ./tsconfig.build.json && tsc-alias -p ./tsconfig.build.json",
+    "build:compile": "npm run build:compile:tsc && npm run build:compile:bun --if-present",
+    "build": "npm run build:clean && npm run build:compile && npm run build:complete --if-present",
+    "test:commits": "LAST_TAG=$(git describe --tags --abbrev=0 @^ 2> /dev/null || git rev-list --max-parents=0 HEAD) && npx commitlint --from $LAST_TAG --to HEAD --verbose",
+    "test:types": "tsc -p ./tsconfig.json --noEmit",
+    "test:format:biome": "biome format",
+    "test:format": "npm run test:format:biome",
+    "test:lint:deps": "npx depcheck -c ./.depcheckrc.yml",
+    "test:lint:biome": "biome check --diagnostic-level=error",
+    "test:lint:biome:all": "biome check",
+    "test:lint": "npm run test:lint:biome && npm run test:lint:deps",
+    "test:unit": "jest -c ./jest.unit.config.ts --forceExit --verbose --passWithNoTests $([ -z $THOROUGH ] && echo '--changedSince=main') $([ -n $RESNAP ] && echo '--updateSnapshot')",
+    "test:integration": "jest -c ./jest.integration.config.ts --forceExit --verbose --passWithNoTests $([ -z $THOROUGH ] && echo '--changedSince=main') $([ -n $RESNAP ] && echo '--updateSnapshot')",
+    "test:acceptance:locally": "npm run build && LOCALLY=true jest -c ./jest.acceptance.config.ts --forceExit --verbose --runInBand --passWithNoTests $([ -n $RESNAP ] && echo '--updateSnapshot')",
+    "test": "npm run test:commits && npm run test:types && npm run test:format && npm run test:lint && npm run test:unit && npm run test:integration && npm run test:acceptance:locally",
+    "test:acceptance": "npm run build && jest -c ./jest.acceptance.config.ts --forceExit --verbose --runInBand --passWithNoTests $([ -n $RESNAP ] && echo '--updateSnapshot')",
+    "prepush": "npm run test && npm run build",
+    "prepublish": "npm run build",
+    "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"
+  }
+}

package/readme.md

@@ -0,0 +1,80 @@
+# rhachet-brains-openai
+
+rhachet BrainAtom & BrainRepl contracts for openai inference
+
+## install
+
+```sh
+npm install rhachet-brains-openai
+```
+
+## usage
+
+```ts
+import { genBrainAtom, genBrainRepl } from 'rhachet-brains-openai';
+import { z } from 'zod';
+
+// create a brain atom for direct model inference
+const brainAtom = genBrainAtom({ slug: 'openai/gpt-4o-mini' });
+
+// simple string output
+const response = await brainAtom.ask({
+  role: { briefs: [] },
+  prompt: 'explain this code',
+  schema: { output: z.string() },
+});
+
+// structured object output
+const result = await brainAtom.ask({
+  role: { briefs: [] },
+  prompt: 'analyze this code',
+  schema: { output: z.object({ summary: z.string(), issues: z.array(z.string()) }) },
+});
+
+// create a brain repl for agentic tasks
+const brainRepl = genBrainRepl({ slug: 'openai/codex' });
+
+const result = await brainRepl.ask({
+  role: { briefs: [] },
+  prompt: 'analyze this codebase',
+  schema: { output: z.object({ content: z.string() }) },
+});
+
+// use act() for read+write operations
+const result = await brainRepl.act({
+  role: { briefs: [] },
+  prompt: 'refactor this module',
+  schema: { output: z.object({ content: z.string() }) },
+});
+```
+
+## available brains
+
+### atoms (via genBrainAtom)
+
+stateless inference without tool use.
+
+| slug                 | model       | description                                   |
+| -------------------- | ----------- | --------------------------------------------- |
+| `openai/gpt-4o`      | gpt-4o      | multimodal model for reasoning and vision     |
+| `openai/gpt-4o-mini` | gpt-4o-mini | fast and cost-effective multimodal model      |
+| `openai/gpt-4-turbo` | gpt-4-turbo | high capability with vision support           |
+| `openai/o1`          | o1          | advanced reasoning model for complex problems |
+| `openai/o1-mini`     | o1-mini     | fast reasoning model for coding and math      |
+| `openai/o1-preview`  | o1-preview  | preview of advanced reasoning capabilities    |
+
+### repls (via genBrainRepl)
+
+agentic coding assistant with tool use via codex-sdk.
+
+| slug                | model              | description                               |
+| ------------------- | ------------------ | ----------------------------------------- |
+| `openai/codex`      | default            | uses SDK default (gpt-5.1-codex-max)      |
+| `openai/codex/max`  | gpt-5.1-codex-max  | optimized for long-horizon agentic coding |
+| `openai/codex/mini` | gpt-5.1-codex-mini | fast and cost-effective                   |
+| `openai/codex/5.2`  | gpt-5.2-codex      | most advanced agentic coding model        |
+
+## sources
+
+- [Codex Models Documentation](https://developers.openai.com/codex/models/)
+- [Codex SDK Documentation](https://developers.openai.com/codex/sdk/)