rhachet-brains-openai 0.1.9 → 0.2.1

package/dist/domain.objects/BrainAtom.config.d.ts

@@ -0,0 +1,25 @@
+import type { BrainSpec } from 'rhachet';
+/**
+ * .what = supported openai brain atom slugs
+ * .why = enables type-safe slug specification with model variants
+ */
+export type OpenaiBrainAtomSlug = 'openai/gpt/4o' | 'openai/gpt/4o-mini' | 'openai/gpt/4-turbo' | 'openai/gpt/4.1' | 'openai/gpt/4.1-mini' | 'openai/gpt/4.1-nano' | 'openai/o/1' | 'openai/o/1-mini' | 'openai/o/1-preview' | 'openai/o/3' | 'openai/o/3-mini' | 'openai/o/3-pro' | 'openai/o/4-mini' | 'openai/gpt/5' | 'openai/gpt/5-mini' | 'openai/gpt/5-pro' | 'openai/gpt/5-thoughtful' | 'openai/gpt/5-thoughtful-mini' | 'openai/gpt/5.1-instant' | 'openai/gpt/5.1-thoughtful' | 'openai/gpt/5.2-instant' | 'openai/gpt/5.2-pro' | 'openai/gpt/5.2-thoughtful' | 'openai/gpt/codex/5.1-max' | 'openai/gpt/codex/5.1-mini' | 'openai/gpt/codex/5.2';
+/**
+ * .what = atom config type
+ * .why = shared type for model configs
+ */
+export type BrainAtomConfig = {
+    model: string;
+    description: string;
+    spec: BrainSpec;
+};
+/**
+ * .what = brain spec configuration by atom slug
+ * .why = maps slugs to api model names, descriptions, and specs
+ *
+ * .refs
+ *   - https://openai.com/api/pricing/
+ *   - https://platform.openai.com/docs/models
+ *   - https://platform.openai.com/docs/api-reference/responses
+ */
+export declare const CONFIG_BY_ATOM_SLUG: Record<OpenaiBrainAtomSlug, BrainAtomConfig>;

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

@@ -1,19 +1,14 @@
-import { 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';
+import { BrainAtom } from 'rhachet/brains';
+import { type OpenaiBrainAtomSlug } from '../../domain.objects/BrainAtom.config';
 /**
  * .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
+ *   genBrainAtom({ slug: 'openai/gpt/4o' })
+ *   genBrainAtom({ slug: 'openai/gpt/4o-mini' }) // fast + cheap
+ *   genBrainAtom({ slug: 'openai/o/1' }) // advanced reason
  */
 export declare const genBrainAtom: (input: {
-    slug: OpenAIAtomSlug;
+    slug: OpenaiBrainAtomSlug;
 }) => BrainAtom;
-export {};

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

@@ -1,19 +1,27 @@
-import { BrainRepl } from 'rhachet';
+import { BrainRepl } from 'rhachet/brains';
 /**
- * .what = supported openai codex repl slugs
+ * .what = supported openai brain repl slugs
  * .why = enables type-safe slug specification with model variants
+ *
+ * .structure
+ *   openai/codex                → default (5.1-max)
+ *   openai/codex/{5.1,5.2}      → version (defaults to max tier)
+ *   openai/codex/{mini,max}     → capability tier (defaults to 5.1)
+ *   openai/codex/{mini,max}/5.1 → explicit version + tier
+ *
+ * .note = 5.2 has only one variant (gpt-5.2-codex); mini/max/5.2 slugs will be added when available
  */
-type CodexSlug = 'openai/codex' | 'openai/codex/max' | 'openai/codex/mini' | 'openai/codex/5.2';
+export type OpenaiBrainReplSlug = 'openai/codex' | 'openai/codex/5.1' | 'openai/codex/5.2' | 'openai/codex/mini' | 'openai/codex/max' | 'openai/codex/mini/5.1' | 'openai/codex/max/5.1';
 /**
  * .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
+ *   genBrainRepl({ slug: 'openai/codex' })          // default (5.1-max)
+ *   genBrainRepl({ slug: 'openai/codex/5.2' })      // version only (5.2)
+ *   genBrainRepl({ slug: 'openai/codex/mini' })     // tier only (5.1-mini)
+ *   genBrainRepl({ slug: 'openai/codex/max/5.2' })  // tier + version
  */
 export declare const genBrainRepl: (input: {
-    slug: CodexSlug;
+    slug: OpenaiBrainReplSlug;
 }) => BrainRepl;
-export {};