rhachet-brains-fireworksai 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,7 @@
+import type { BrainAtom } from 'rhachet';
+/**
+ * .what = returns all brain atoms provided by fireworks ai
+ * .why = enables consumers to register fireworks ai atoms with genContextBrain
+ */
+export declare const getBrainAtomsByFireworksAI: () => BrainAtom[];
+export { genBrainAtom } from '../../domain.operations/atom/genBrainAtom';

package/dist/contract/sdk/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genBrainAtom = exports.getBrainAtomsByFireworksAI = void 0;
+const genBrainAtom_1 = require("../../domain.operations/atom/genBrainAtom");
+/**
+ * .what = returns all brain atoms provided by fireworks ai
+ * .why = enables consumers to register fireworks ai atoms with genContextBrain
+ */
+const getBrainAtomsByFireworksAI = () => {
+    return [
+        (0, genBrainAtom_1.genBrainAtom)({ slug: 'fireworks/qwen3/coder-next' }),
+        (0, genBrainAtom_1.genBrainAtom)({ slug: 'fireworks/qwen3/coder-480b' }),
+        (0, genBrainAtom_1.genBrainAtom)({ slug: 'fireworks/qwen3/235b' }),
+        (0, genBrainAtom_1.genBrainAtom)({ slug: 'fireworks/deepseek/v3.1' }),
+        (0, genBrainAtom_1.genBrainAtom)({ slug: 'fireworks/deepseek/r1' }),
+        (0, genBrainAtom_1.genBrainAtom)({ slug: 'fireworks/kimi/k2' }),
+        (0, genBrainAtom_1.genBrainAtom)({ slug: 'fireworks/kimi/k2.5' }),
+        (0, genBrainAtom_1.genBrainAtom)({ slug: 'fireworks/llama4/maverick' }),
+        (0, genBrainAtom_1.genBrainAtom)({ slug: 'fireworks/llama3.3/70b' }),
+        (0, genBrainAtom_1.genBrainAtom)({ slug: 'fireworks/glm/4.7' }),
+    ];
+};
+exports.getBrainAtomsByFireworksAI = getBrainAtomsByFireworksAI;
+// re-export factory for direct access
+var genBrainAtom_2 = require("../../domain.operations/atom/genBrainAtom");
+Object.defineProperty(exports, "genBrainAtom", { enumerable: true, get: function () { return genBrainAtom_2.genBrainAtom; } });
+//# 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,4EAAyE;AAEzE;;;GAGG;AACI,MAAM,0BAA0B,GAAG,GAAgB,EAAE;IAC1D,OAAO;QACL,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,4BAA4B,EAAE,CAAC;QACpD,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,4BAA4B,EAAE,CAAC;QACpD,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC;QAC9C,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE,CAAC;QACjD,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;QAC/C,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;QAC3C,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC;QAC7C,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,2BAA2B,EAAE,CAAC;QACnD,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC;QAChD,IAAA,2BAAY,EAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;KAC5C,CAAC;AACJ,CAAC,CAAC;AAbW,QAAA,0BAA0B,8BAarC;AAEF,sCAAsC;AACtC,0EAAyE;AAAhE,4GAAA,YAAY,OAAA"}

package/dist/domain.operations/atom/BrainAtom.config.d.ts

@@ -0,0 +1,25 @@
+import { BrainSpec } from 'rhachet';
+/**
+ * .what = atom config type
+ * .why = shared type for model configs
+ */
+export type BrainAtomConfig = {
+    model: string;
+    description: string;
+    spec: BrainSpec;
+};
+/**
+ * .what = supported fireworks ai atom slugs
+ * .why = enables type-safe slug specification with model variants
+ */
+export type FireworksBrainAtomSlug = 'fireworks/qwen3/coder-next' | 'fireworks/qwen3/coder-480b' | 'fireworks/qwen3/235b' | 'fireworks/deepseek/v3.1' | 'fireworks/deepseek/r1' | 'fireworks/kimi/k2' | 'fireworks/kimi/k2.5' | 'fireworks/llama4/maverick' | 'fireworks/llama3.3/70b' | 'fireworks/glm/4.7';
+/**
+ * .what = model configuration by slug
+ * .why = maps slugs to api model names, descriptions, and specs
+ *
+ * .sources:
+ *   - rates: https://fireworks.ai/pricing
+ *   - models: https://docs.fireworks.ai/docs/serverless-models
+ *   - api docs: https://docs.fireworks.ai/reference/chat-completions-1
+ */
+export declare const CONFIG_BY_ATOM_SLUG: Record<FireworksBrainAtomSlug, BrainAtomConfig>;

package/dist/domain.operations/atom/BrainAtom.config.js

@@ -0,0 +1,369 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_BY_ATOM_SLUG = void 0;
+const iso_price_1 = require("iso-price");
+const rhachet_1 = require("rhachet");
+/**
+ * .what = model configuration by slug
+ * .why = maps slugs to api model names, descriptions, and specs
+ *
+ * .sources:
+ *   - rates: https://fireworks.ai/pricing
+ *   - models: https://docs.fireworks.ai/docs/serverless-models
+ *   - api docs: https://docs.fireworks.ai/reference/chat-completions-1
+ */
+exports.CONFIG_BY_ATOM_SLUG = {
+    /**
+     * qwen3-coder-next
+     * .sources:
+     *   - rates: https://fireworks.ai/pricing ($0.50/1M input, $1.20/1M output)
+     *   - context: 262K
+     *   - swe-bench: 74.2% verified
+     *   - architecture: 80B total, 3B active (moe)
+     */
+    'fireworks/qwen3/coder-next': {
+        model: 'Qwen/Qwen3-Coder-Next-FP8',
+        description: 'qwen3-coder-next - best cost/performance for code (262K)',
+        spec: new rhachet_1.BrainSpec({
+            cost: {
+                time: {
+                    speed: { tokens: 150, per: { seconds: 1 } },
+                    latency: { seconds: 0.5 },
+                },
+                cash: {
+                    per: 'token',
+                    cache: {
+                        get: (0, iso_price_1.asIsoPrice)('$0'), // no cache rate on fireworks ai
+                        set: (0, iso_price_1.asIsoPrice)('$0'),
+                    },
+                    input: (0, iso_price_1.dividePrice)({ of: '$0.50', by: 1000000 }), // $0.50/1M tokens
+                    output: (0, iso_price_1.dividePrice)({ of: '$1.20', by: 1000000 }), // $1.20/1M tokens
+                },
+            },
+            gain: {
+                size: { context: { tokens: 262000 } }, // 262K context
+                grades: { swe: 74.2 }, // 74.2% swe-bench verified
+                cutoff: '2025-06-01',
+                domain: 'SOFTWARE',
+                skills: { tooluse: true },
+            },
+        }),
+    },
+    /**
+     * qwen3-coder-480b
+     * .sources:
+     *   - rates: https://fireworks.ai/pricing ($2.00/1M input, $2.00/1M output)
+     *   - context: 262K
+     *   - swe-bench: 69.6% verified
+     *   - architecture: 480B total, 35B active (moe)
+     */
+    'fireworks/qwen3/coder-480b': {
+        model: 'Qwen/Qwen3-Coder-480B-A35B-Instruct-FP8',
+        description: 'qwen3-coder-480b - large code model (262K)',
+        spec: new rhachet_1.BrainSpec({
+            cost: {
+                time: {
+                    speed: { tokens: 80, per: { seconds: 1 } },
+                    latency: { seconds: 1 },
+                },
+                cash: {
+                    per: 'token',
+                    cache: {
+                        get: (0, iso_price_1.asIsoPrice)('$0'),
+                        set: (0, iso_price_1.asIsoPrice)('$0'),
+                    },
+                    input: (0, iso_price_1.dividePrice)({ of: '$2.00', by: 1000000 }), // $2.00/1M tokens
+                    output: (0, iso_price_1.dividePrice)({ of: '$2.00', by: 1000000 }), // $2.00/1M tokens
+                },
+            },
+            gain: {
+                size: { context: { tokens: 262000 } }, // 262K context
+                grades: { swe: 69.6 }, // 69.6% swe-bench verified
+                cutoff: '2025-06-01',
+                domain: 'SOFTWARE',
+                skills: { tooluse: true },
+            },
+        }),
+    },
+    /**
+     * qwen3-235b
+     * .sources:
+     *   - rates: https://fireworks.ai/pricing ($0.20/1M input, $0.60/1M output)
+     *   - context: 131K
+     *   - architecture: 235B total, 22B active (moe)
+     */
+    'fireworks/qwen3/235b': {
+        model: 'Qwen/Qwen3-235B-A22B-Instruct-2507-tput',
+        description: 'qwen3-235b - general purpose (131K)',
+        spec: new rhachet_1.BrainSpec({
+            cost: {
+                time: {
+                    speed: { tokens: 120, per: { seconds: 1 } },
+                    latency: { seconds: 0.5 },
+                },
+                cash: {
+                    per: 'token',
+                    cache: {
+                        get: (0, iso_price_1.asIsoPrice)('$0'),
+                        set: (0, iso_price_1.asIsoPrice)('$0'),
+                    },
+                    input: (0, iso_price_1.dividePrice)({ of: '$0.20', by: 1000000 }), // $0.20/1M tokens
+                    output: (0, iso_price_1.dividePrice)({ of: '$0.60', by: 1000000 }), // $0.60/1M tokens
+                },
+            },
+            gain: {
+                size: { context: { tokens: 131000 } }, // 131K context
+                grades: {},
+                cutoff: '2025-07-01',
+                domain: 'ALL',
+                skills: { tooluse: true },
+            },
+        }),
+    },
+    /**
+     * deepseek-v3.1
+     * .sources:
+     *   - rates: https://fireworks.ai/pricing ($1.25/1M input, $1.25/1M output)
+     *   - context: 128K
+     *   - architecture: 671B total, 37B active (moe)
+     */
+    'fireworks/deepseek/v3.1': {
+        model: 'deepseek-ai/DeepSeek-V3.1',
+        description: 'deepseek-v3.1 - frontier open-source (128K)',
+        spec: new rhachet_1.BrainSpec({
+            cost: {
+                time: {
+                    speed: { tokens: 100, per: { seconds: 1 } },
+                    latency: { seconds: 1 },
+                },
+                cash: {
+                    per: 'token',
+                    cache: {
+                        get: (0, iso_price_1.asIsoPrice)('$0'),
+                        set: (0, iso_price_1.asIsoPrice)('$0'),
+                    },
+                    input: (0, iso_price_1.dividePrice)({ of: '$1.25', by: 1000000 }), // $1.25/1M tokens
+                    output: (0, iso_price_1.dividePrice)({ of: '$1.25', by: 1000000 }), // $1.25/1M tokens
+                },
+            },
+            gain: {
+                size: { context: { tokens: 128000 } }, // 128K context
+                grades: {},
+                cutoff: '2025-03-01',
+                domain: 'ALL',
+                skills: { tooluse: true },
+            },
+        }),
+    },
+    /**
+     * deepseek-r1
+     * .sources:
+     *   - rates: https://fireworks.ai/pricing ($3.00/1M input, $7.00/1M output)
+     *   - context: 128K
+     *   - architecture: 671B total, 37B active (moe), chain-of-thought
+     */
+    'fireworks/deepseek/r1': {
+        model: 'deepseek-ai/DeepSeek-R1',
+        description: 'deepseek-r1 - chain-of-thought (128K)',
+        spec: new rhachet_1.BrainSpec({
+            cost: {
+                time: {
+                    speed: { tokens: 60, per: { seconds: 1 } },
+                    latency: { seconds: 1.5 },
+                },
+                cash: {
+                    per: 'token',
+                    cache: {
+                        get: (0, iso_price_1.asIsoPrice)('$0'),
+                        set: (0, iso_price_1.asIsoPrice)('$0'),
+                    },
+                    input: (0, iso_price_1.dividePrice)({ of: '$3.00', by: 1000000 }), // $3.00/1M tokens
+                    output: (0, iso_price_1.dividePrice)({ of: '$7.00', by: 1000000 }), // $7.00/1M tokens
+                },
+            },
+            gain: {
+                size: { context: { tokens: 128000 } }, // 128K context
+                grades: {},
+                cutoff: '2025-03-01',
+                domain: 'ALL',
+                skills: { tooluse: true },
+            },
+        }),
+    },
+    /**
+     * kimi-k2
+     * .sources:
+     *   - rates: https://fireworks.ai/pricing ($1.00/1M input, $3.00/1M output)
+     *   - context: 128K
+     *   - architecture: 1T total (moe)
+     */
+    'fireworks/kimi/k2': {
+        model: 'moonshotai/Kimi-K2-Instruct',
+        description: 'kimi-k2 - large general purpose (128K)',
+        spec: new rhachet_1.BrainSpec({
+            cost: {
+                time: {
+                    speed: { tokens: 80, per: { seconds: 1 } },
+                    latency: { seconds: 1 },
+                },
+                cash: {
+                    per: 'token',
+                    cache: {
+                        get: (0, iso_price_1.asIsoPrice)('$0'),
+                        set: (0, iso_price_1.asIsoPrice)('$0'),
+                    },
+                    input: (0, iso_price_1.dividePrice)({ of: '$1.00', by: 1000000 }), // $1.00/1M tokens
+                    output: (0, iso_price_1.dividePrice)({ of: '$3.00', by: 1000000 }), // $3.00/1M tokens
+                },
+            },
+            gain: {
+                size: { context: { tokens: 128000 } }, // 128K context
+                grades: {},
+                cutoff: '2025-06-01',
+                domain: 'ALL',
+                skills: { tooluse: true },
+            },
+        }),
+    },
+    /**
+     * kimi-k2.5
+     * .sources:
+     *   - rates: https://fireworks.ai/pricing ($0.50/1M input, $2.80/1M output)
+     *   - context: 128K
+     *   - swe-bench: 76.8% verified
+     */
+    'fireworks/kimi/k2.5': {
+        model: 'moonshotai/Kimi-K2.5',
+        description: 'kimi-k2.5 - best swe-bench on fireworks ai (128K)',
+        spec: new rhachet_1.BrainSpec({
+            cost: {
+                time: {
+                    speed: { tokens: 100, per: { seconds: 1 } },
+                    latency: { seconds: 0.8 },
+                },
+                cash: {
+                    per: 'token',
+                    cache: {
+                        get: (0, iso_price_1.asIsoPrice)('$0'),
+                        set: (0, iso_price_1.asIsoPrice)('$0'),
+                    },
+                    input: (0, iso_price_1.dividePrice)({ of: '$0.50', by: 1000000 }), // $0.50/1M tokens
+                    output: (0, iso_price_1.dividePrice)({ of: '$2.80', by: 1000000 }), // $2.80/1M tokens
+                },
+            },
+            gain: {
+                size: { context: { tokens: 128000 } }, // 128K context
+                grades: { swe: 76.8 }, // 76.8% swe-bench verified
+                cutoff: '2025-07-01',
+                domain: 'ALL',
+                skills: { tooluse: true },
+            },
+        }),
+    },
+    /**
+     * llama-4-maverick
+     * .sources:
+     *   - rates: https://fireworks.ai/pricing ($0.27/1M input, $0.85/1M output)
+     *   - context: 1M
+     *   - architecture: 17B active, 128 experts (moe)
+     */
+    'fireworks/llama4/maverick': {
+        model: 'meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8',
+        description: 'llama-4-maverick - large context (1M)',
+        spec: new rhachet_1.BrainSpec({
+            cost: {
+                time: {
+                    speed: { tokens: 120, per: { seconds: 1 } },
+                    latency: { seconds: 0.5 },
+                },
+                cash: {
+                    per: 'token',
+                    cache: {
+                        get: (0, iso_price_1.asIsoPrice)('$0'),
+                        set: (0, iso_price_1.asIsoPrice)('$0'),
+                    },
+                    input: (0, iso_price_1.dividePrice)({ of: '$0.27', by: 1000000 }), // $0.27/1M tokens
+                    output: (0, iso_price_1.dividePrice)({ of: '$0.85', by: 1000000 }), // $0.85/1M tokens
+                },
+            },
+            gain: {
+                size: { context: { tokens: 1000000 } }, // 1M context
+                grades: {},
+                cutoff: '2025-03-01',
+                domain: 'ALL',
+                skills: { tooluse: true },
+            },
+        }),
+    },
+    /**
+     * llama-3.3-70b
+     * .sources:
+     *   - rates: https://fireworks.ai/pricing ($0.88/1M input, $0.88/1M output)
+     *   - context: 128K
+     *   - architecture: 70B dense
+     */
+    'fireworks/llama3.3/70b': {
+        model: 'meta-llama/Llama-3.3-70B-Instruct-Turbo',
+        description: 'llama-3.3-70b - balanced dense model (128K)',
+        spec: new rhachet_1.BrainSpec({
+            cost: {
+                time: {
+                    speed: { tokens: 150, per: { seconds: 1 } },
+                    latency: { seconds: 0.4 },
+                },
+                cash: {
+                    per: 'token',
+                    cache: {
+                        get: (0, iso_price_1.asIsoPrice)('$0'),
+                        set: (0, iso_price_1.asIsoPrice)('$0'),
+                    },
+                    input: (0, iso_price_1.dividePrice)({ of: '$0.88', by: 1000000 }), // $0.88/1M tokens
+                    output: (0, iso_price_1.dividePrice)({ of: '$0.88', by: 1000000 }), // $0.88/1M tokens
+                },
+            },
+            gain: {
+                size: { context: { tokens: 128000 } }, // 128K context
+                grades: {},
+                cutoff: '2024-12-01',
+                domain: 'ALL',
+                skills: { tooluse: true },
+            },
+        }),
+    },
+    /**
+     * glm-4.7
+     * .sources:
+     *   - rates: https://fireworks.ai/pricing ($0.45/1M input, $2.00/1M output)
+     *   - context: 128K
+     *   - swe-bench: 73.8% verified
+     */
+    'fireworks/glm/4.7': {
+        model: 'zai-org/GLM-4.7',
+        description: 'glm-4.7 - strong code + general (128K)',
+        spec: new rhachet_1.BrainSpec({
+            cost: {
+                time: {
+                    speed: { tokens: 100, per: { seconds: 1 } },
+                    latency: { seconds: 0.8 },
+                },
+                cash: {
+                    per: 'token',
+                    cache: {
+                        get: (0, iso_price_1.asIsoPrice)('$0'),
+                        set: (0, iso_price_1.asIsoPrice)('$0'),
+                    },
+                    input: (0, iso_price_1.dividePrice)({ of: '$0.45', by: 1000000 }), // $0.45/1M tokens
+                    output: (0, iso_price_1.dividePrice)({ of: '$2.00', by: 1000000 }), // $2.00/1M tokens
+                },
+            },
+            gain: {
+                size: { context: { tokens: 128000 } }, // 128K context
+                grades: { swe: 73.8 }, // 73.8% swe-bench verified
+                cutoff: '2025-06-01',
+                domain: 'ALL',
+                skills: { tooluse: true },
+            },
+        }),
+    },
+};
+//# sourceMappingURL=BrainAtom.config.js.map

package/dist/domain.operations/atom/BrainAtom.config.js.map

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

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

@@ -0,0 +1,17 @@
+import { BrainAtom } from 'rhachet/brains';
+import { type FireworksBrainAtomSlug } from './BrainAtom.config';
+export type { FireworksBrainAtomSlug } from './BrainAtom.config';
+/**
+ * .what = factory to generate fireworks ai brain atom instances
+ * .why = enables model variant selection via slug
+ *
+ * .note = fireworks ai api is openai-compatible with baseURL override
+ *
+ * .example
+ *   genBrainAtom({ slug: 'fireworks/qwen3/coder-next' })
+ *   genBrainAtom({ slug: 'fireworks/llama3.3/70b' }) // fast + cheap
+ *   genBrainAtom({ slug: 'fireworks/kimi/k2.5' }) // best swe-bench
+ */
+export declare const genBrainAtom: (input: {
+    slug: FireworksBrainAtomSlug;
+}) => BrainAtom;

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

@@ -0,0 +1,234 @@
+"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 helpful_errors_1 = require("helpful-errors");
+const openai_1 = __importDefault(require("openai"));
+const brains_1 = require("rhachet/brains");
+const zod_1 = require("zod");
+const castContentToOutputSchema_1 = require("../../infra/cast/castContentToOutputSchema");
+const castFromFireworksToolCall_1 = require("../../infra/cast/castFromFireworksToolCall");
+const castIntoFireworksToolDef_1 = require("../../infra/cast/castIntoFireworksToolDef");
+const castIntoFireworksToolMessages_1 = require("../../infra/cast/castIntoFireworksToolMessages");
+const BrainAtom_config_1 = require("./BrainAtom.config");
+/**
+ * .what = factory to generate fireworks ai brain atom instances
+ * .why = enables model variant selection via slug
+ *
+ * .note = fireworks ai api is openai-compatible with baseURL override
+ *
+ * .example
+ *   genBrainAtom({ slug: 'fireworks/qwen3/coder-next' })
+ *   genBrainAtom({ slug: 'fireworks/llama3.3/70b' }) // fast + cheap
+ *   genBrainAtom({ slug: 'fireworks/kimi/k2.5' }) // best swe-bench
+ */
+const genBrainAtom = (input) => {
+    const config = BrainAtom_config_1.CONFIG_BY_ATOM_SLUG[input.slug];
+    return new brains_1.BrainAtom({
+        repo: 'fireworks',
+        slug: input.slug,
+        description: config.description,
+        spec: config.spec,
+        /**
+         * .what = stateless inference with optional tool use
+         * .why = provides direct model access for tasks
+         *
+         * .note = supports continuation via `on.episode`
+         * .note = supports tool use via `plugs.tools`
+         */
+        ask: async (askInput, context) => {
+            // track start time for elapsed duration
+            const startedAt = Date.now();
+            // compose system prompt from briefs
+            const systemPrompt = askInput.role.briefs
+                ? await (0, brains_1.castBriefsToPrompt)({ briefs: askInput.role.briefs })
+                : undefined;
+            // get openai client from context or create new one with fireworks ai baseURL
+            const openai = context?.openai ??
+                new openai_1.default({
+                    apiKey: process.env.FIREWORKS_API_KEY,
+                    baseURL: 'https://api.fireworks.ai/inference/v1',
+                });
+            // build messages array with prior exchanges for continuation
+            const messages = [];
+            if (systemPrompt) {
+                messages.push({ role: 'system', content: systemPrompt });
+            }
+            if (askInput.on?.episode) {
+                for (const exchange of askInput.on.episode.exchanges) {
+                    messages.push({ role: 'user', content: exchange.input });
+                    messages.push({ role: 'assistant', content: exchange.output });
+                }
+            }
+            // handle prompt: string or BrainPlugToolExecution[]
+            const promptIsToolExecutions = Array.isArray(askInput.prompt);
+            if (promptIsToolExecutions) {
+                // tool continuation: add assistant message with tool_calls, then tool messages
+                const executions = askInput.prompt;
+                // reconstruct assistant message with tool_calls from prior exchange
+                // note: this is needed because fireworks ai expects the assistant message before tool messages
+                const toolCalls = executions.map((exec) => ({
+                    id: exec.exid,
+                    type: 'function',
+                    function: {
+                        name: exec.slug,
+                        arguments: JSON.stringify(exec.input),
+                    },
+                }));
+                messages.push({
+                    role: 'assistant',
+                    content: null,
+                    tool_calls: toolCalls,
+                });
+                // add tool result messages
+                const toolMessages = (0, castIntoFireworksToolMessages_1.castIntoFireworksToolMessages)({ executions });
+                messages.push(...toolMessages);
+            }
+            else {
+                // regular prompt
+                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);
+            // convert tools to fireworks ai format if plugged
+            const tools = askInput.plugs?.tools?.map((tool) => (0, castIntoFireworksToolDef_1.castIntoFireworksToolDef)({ tool }));
+            // determine if tools are present and whether this is a continuation
+            const hasTools = tools && tools.length > 0;
+            const isToolContinuation = promptIsToolExecutions;
+            // fail-fast: tools + structured output schema not supported by most models
+            // vllm constraint: "model must not generate both text and tool calls in same generation"
+            // when tools are plugged, output schema must be z.string() to allow plain text responses
+            if (hasTools && !isToolContinuation) {
+                const schemaType = jsonSchema.type;
+                if (schemaType !== 'string') {
+                    throw new helpful_errors_1.BadRequestError(`when tools are plugged, output schema must be z.string() (found: ${schemaType}). most open-source models support either tool_calls or structured json, but not both. use z.string() and parse the response yourself if structure is needed.`, { schemaType, tools: askInput.plugs?.tools?.map((t) => t.slug) });
+                }
+            }
+            // include response_format only when we want structured output (not tool calls)
+            // vllm constraint: "model must not generate both text and tool calls in same generation"
+            // when response_format is present, model outputs json content, not tool_calls
+            // so we omit response_format on initial tool requests to enable tool call
+            const wantsToolCalls = hasTools && !isToolContinuation;
+            const wantStructuredOutput = !wantsToolCalls;
+            const response = await openai.chat.completions.create({
+                model: config.model,
+                messages,
+                ...(hasTools ? { tools, tool_choice: 'auto' } : {}),
+                ...(wantStructuredOutput
+                    ? {
+                        response_format: {
+                            type: 'json_schema',
+                            json_schema: {
+                                name: 'response',
+                                strict: true,
+                                schema: jsonSchema,
+                            },
+                        },
+                    }
+                    : {}),
+            });
+            // extract response message
+            const message = response.choices[0]?.message;
+            const content = message?.content ?? '';
+            const toolCalls = message?.tool_calls;
+            // calculate elapsed time
+            const elapsedMs = Date.now() - startedAt;
+            // extract token usage from response
+            const tokensInput = response.usage?.prompt_tokens ?? 0;
+            const tokensOutput = response.usage?.completion_tokens ?? 0;
+            const tokensCached = response.usage?.prompt_tokens_details?.cached_tokens ?? 0;
+            // calculate character counts
+            const promptLength = promptIsToolExecutions
+                ? JSON.stringify(askInput.prompt).length
+                : askInput.prompt.length;
+            const charsInput = (systemPrompt?.length ?? 0) + promptLength;
+            const charsOutput = content.length;
+            // define size for metrics and cost calculation
+            const size = {
+                tokens: {
+                    input: tokensInput,
+                    output: tokensOutput,
+                    cache: { get: tokensCached, set: 0 },
+                },
+                chars: {
+                    input: charsInput,
+                    output: charsOutput,
+                    cache: { get: 0, set: 0 },
+                },
+            };
+            // calculate cash costs via rhachet utility
+            const { cash } = (0, brains_1.calcBrainOutputCost)({
+                for: { tokens: size.tokens },
+                with: { cost: { cash: config.spec.cost.cash } },
+            });
+            // build metrics
+            const metrics = new brains_1.BrainOutputMetrics({
+                size,
+                cost: {
+                    time: { milliseconds: elapsedMs },
+                    cash,
+                },
+            });
+            // handle tool calls if present
+            if (toolCalls && toolCalls.length > 0) {
+                // brain requested tool invocations
+                const invocations = toolCalls.map((toolCall) => (0, castFromFireworksToolCall_1.castFromFireworksToolCall)({ toolCall }));
+                // build continuables for tool call exchange
+                const { episode, series } = await (0, brains_1.genBrainContinuables)({
+                    for: { grain: 'atom' },
+                    on: { episode: askInput.on?.episode ?? null, series: null },
+                    with: {
+                        exchange: {
+                            input: promptIsToolExecutions
+                                ? JSON.stringify(askInput.prompt)
+                                : askInput.prompt,
+                            output: JSON.stringify(toolCalls),
+                            exid: response.id ?? null,
+                        },
+                        episode: { exid: response.id ?? null },
+                    },
+                });
+                // note: cast input because TypeScript can't verify conditional types at construction
+                return new brains_1.BrainOutput({
+                    output: null,
+                    calls: { tools: invocations },
+                    metrics,
+                    episode,
+                    series,
+                });
+            }
+            // parse response content based on schema type
+            const output = (0, castContentToOutputSchema_1.castContentToOutputSchema)({
+                content,
+                schema: askInput.schema.output,
+            });
+            // build continuables (episode + series) for this invocation
+            const { episode, series } = await (0, brains_1.genBrainContinuables)({
+                for: { grain: 'atom' },
+                on: { episode: askInput.on?.episode ?? null, series: null },
+                with: {
+                    exchange: {
+                        input: promptIsToolExecutions
+                            ? JSON.stringify(askInput.prompt)
+                            : askInput.prompt,
+                        output: content,
+                        exid: response.id ?? null,
+                    },
+                    episode: { exid: response.id ?? null },
+                },
+            });
+            // note: cast input because TypeScript can't verify conditional types at construction
+            return new brains_1.BrainOutput({
+                output,
+                calls: null,
+                metrics,
+                episode,
+                series,
+            });
+        },
+    });
+};
+exports.genBrainAtom = genBrainAtom;
+//# sourceMappingURL=genBrainAtom.js.map

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

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

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './contract/sdk';

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./contract/sdk"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B"}

package/dist/infra/cast/castContentToOutputSchema.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+/**
+ * .what = parses api response content based on schema type
+ * .why = object schemas need JSON.parse; string schemas take content directly
+ *
+ * .note = string schemas (plain or nullable) receive plain text from api
+ *         because vllm constraint requires z.string() for tool use output
+ */
+export declare const castContentToOutputSchema: <T>(input: {
+    content: string;
+    schema: z.Schema<T>;
+}) => T;

package/dist/infra/cast/castContentToOutputSchema.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.castContentToOutputSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * .what = parses api response content based on schema type
+ * .why = object schemas need JSON.parse; string schemas take content directly
+ *
+ * .note = string schemas (plain or nullable) receive plain text from api
+ *         because vllm constraint requires z.string() for tool use output
+ */
+const castContentToOutputSchema = (input) => {
+    const jsonSchema = zod_1.z.toJSONSchema(input.schema);
+    // detect string-like schemas: plain string or nullable string (anyOf with string + null)
+    const isStringSchema = (() => {
+        if (jsonSchema.type === 'string')
+            return true;
+        if (jsonSchema.anyOf) {
+            const types = jsonSchema.anyOf.map((s) => s.type).filter(Boolean);
+            // nullable string: anyOf with string and null only
+            return (types.length === 2 && types.includes('string') && types.includes('null'));
+        }
+        return false;
+    })();
+    // string schemas: parse content directly (no JSON.parse)
+    if (isStringSchema) {
+        return input.schema.parse(input.content);
+    }
+    // object/array schemas: JSON parse first
+    return input.schema.parse(JSON.parse(input.content));
+};
+exports.castContentToOutputSchema = castContentToOutputSchema;
+//# sourceMappingURL=castContentToOutputSchema.js.map

package/dist/infra/cast/castContentToOutputSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"castContentToOutputSchema.js","sourceRoot":"","sources":["../../../src/infra/cast/castContentToOutputSchema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;;;;;GAMG;AACI,MAAM,yBAAyB,GAAG,CAAI,KAG5C,EAAK,EAAE;IACN,MAAM,UAAU,GAAG,OAAC,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAG7C,CAAC;IAEF,yFAAyF;IACzF,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE;QAC3B,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC9C,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAClE,mDAAmD;YACnD,OAAO,CACL,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CACzE,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,EAAE,CAAC;IAEL,yDAAyD;IACzD,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,yCAAyC;IACzC,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;AACvD,CAAC,CAAC;AA7BW,QAAA,yBAAyB,6BA6BpC"}

package/dist/infra/cast/castFromFireworksToolCall.d.ts

@@ -0,0 +1,14 @@
+import type OpenAI from 'openai';
+import type { BrainPlugToolInvocation } from 'rhachet/brains';
+/**
+ * .what = converts a fireworks ai / openai tool call to rhachet invocation
+ * .why = enables callers to receive typed tool invocations from the brain
+ *
+ * .note = fireworks ai uses openai's tool_calls format:
+ *   - id: string (maps to exid)
+ *   - function.name: string (maps to slug)
+ *   - function.arguments: JSON string (parsed to input)
+ */
+export declare const castFromFireworksToolCall: (input: {
+    toolCall: OpenAI.ChatCompletionMessageToolCall;
+}) => BrainPlugToolInvocation;

package/dist/infra/cast/castFromFireworksToolCall.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.castFromFireworksToolCall = void 0;
+/**
+ * .what = converts a fireworks ai / openai tool call to rhachet invocation
+ * .why = enables callers to receive typed tool invocations from the brain
+ *
+ * .note = fireworks ai uses openai's tool_calls format:
+ *   - id: string (maps to exid)
+ *   - function.name: string (maps to slug)
+ *   - function.arguments: JSON string (parsed to input)
+ */
+const castFromFireworksToolCall = (input) => {
+    // parse arguments from JSON string
+    const parsedInput = JSON.parse(input.toolCall.function.arguments);
+    return {
+        exid: input.toolCall.id,
+        slug: input.toolCall.function.name,
+        input: parsedInput,
+    };
+};
+exports.castFromFireworksToolCall = castFromFireworksToolCall;
+//# sourceMappingURL=castFromFireworksToolCall.js.map

package/dist/infra/cast/castFromFireworksToolCall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"castFromFireworksToolCall.js","sourceRoot":"","sources":["../../../src/infra/cast/castFromFireworksToolCall.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;GAQG;AACI,MAAM,yBAAyB,GAAG,CAAC,KAEzC,EAA2B,EAAE;IAC5B,mCAAmC;IACnC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAElE,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE;QACvB,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI;QAClC,KAAK,EAAE,WAAW;KACnB,CAAC;AACJ,CAAC,CAAC;AAXW,QAAA,yBAAyB,6BAWpC"}

package/dist/infra/cast/castIntoFireworksToolDef.d.ts

@@ -0,0 +1,13 @@
+import type OpenAI from 'openai';
+import type { BrainPlugToolDefinition } from 'rhachet/brains';
+/**
+ * .what = converts a rhachet tool definition to fireworks ai / openai format
+ * .why = enables tool use via fireworks ai's openai-compatible api
+ *
+ * .note = fireworks ai uses openai's function call format:
+ *   - type: 'function'
+ *   - function: { name, description, parameters, strict }
+ */
+export declare const castIntoFireworksToolDef: (input: {
+    tool: BrainPlugToolDefinition;
+}) => OpenAI.ChatCompletionTool;

package/dist/infra/cast/castIntoFireworksToolDef.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.castIntoFireworksToolDef = void 0;
+const zod_1 = require("zod");
+/**
+ * .what = converts a rhachet tool definition to fireworks ai / openai format
+ * .why = enables tool use via fireworks ai's openai-compatible api
+ *
+ * .note = fireworks ai uses openai's function call format:
+ *   - type: 'function'
+ *   - function: { name, description, parameters, strict }
+ */
+const castIntoFireworksToolDef = (input) => {
+    // convert zod schema to json schema for function parameters
+    const parametersSchema = zod_1.z.toJSONSchema(input.tool.schema.input);
+    return {
+        type: 'function',
+        function: {
+            name: input.tool.slug,
+            description: input.tool.description,
+            parameters: parametersSchema,
+            strict: true,
+        },
+    };
+};
+exports.castIntoFireworksToolDef = castIntoFireworksToolDef;
+//# sourceMappingURL=castIntoFireworksToolDef.js.map

package/dist/infra/cast/castIntoFireworksToolDef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"castIntoFireworksToolDef.js","sourceRoot":"","sources":["../../../src/infra/cast/castIntoFireworksToolDef.ts"],"names":[],"mappings":";;;AAEA,6BAAwB;AAExB;;;;;;;GAOG;AACI,MAAM,wBAAwB,GAAG,CAAC,KAExC,EAA6B,EAAE;IAC9B,4DAA4D;IAC5D,MAAM,gBAAgB,GAAG,OAAC,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEjE,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI;YACrB,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW;YACnC,UAAU,EAAE,gBAAgB;YAC5B,MAAM,EAAE,IAAI;SACb;KACF,CAAC;AACJ,CAAC,CAAC;AAfW,QAAA,wBAAwB,4BAenC"}

package/dist/infra/cast/castIntoFireworksToolMessages.d.ts

@@ -0,0 +1,14 @@
+import type OpenAI from 'openai';
+import type { BrainPlugToolExecution } from 'rhachet/brains';
+/**
+ * .what = converts rhachet tool executions to fireworks ai / openai tool messages
+ * .why = enables tool result continuation in the brain conversation
+ *
+ * .note = fireworks ai uses openai's tool message format:
+ *   - role: 'tool'
+ *   - tool_call_id: string (from execution.exid)
+ *   - content: string (JSON stringified output or error)
+ */
+export declare const castIntoFireworksToolMessages: (input: {
+    executions: BrainPlugToolExecution[];
+}) => OpenAI.ChatCompletionToolMessageParam[];

package/dist/infra/cast/castIntoFireworksToolMessages.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.castIntoFireworksToolMessages = void 0;
+/**
+ * .what = converts rhachet tool executions to fireworks ai / openai tool messages
+ * .why = enables tool result continuation in the brain conversation
+ *
+ * .note = fireworks ai uses openai's tool message format:
+ *   - role: 'tool'
+ *   - tool_call_id: string (from execution.exid)
+ *   - content: string (JSON stringified output or error)
+ */
+const castIntoFireworksToolMessages = (input) => {
+    return input.executions.map((execution) => {
+        // format content based on signal
+        const content = execution.signal === 'success'
+            ? JSON.stringify(execution.output)
+            : JSON.stringify({
+                error: execution.output.error.message,
+                signal: execution.signal,
+            });
+        return {
+            role: 'tool',
+            tool_call_id: execution.exid,
+            content,
+        };
+    });
+};
+exports.castIntoFireworksToolMessages = castIntoFireworksToolMessages;
+//# sourceMappingURL=castIntoFireworksToolMessages.js.map

package/dist/infra/cast/castIntoFireworksToolMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"castIntoFireworksToolMessages.js","sourceRoot":"","sources":["../../../src/infra/cast/castIntoFireworksToolMessages.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;GAQG;AACI,MAAM,6BAA6B,GAAG,CAAC,KAE7C,EAA2C,EAAE;IAC5C,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;QACxC,iCAAiC;QACjC,MAAM,OAAO,GACX,SAAS,CAAC,MAAM,KAAK,SAAS;YAC5B,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;YAClC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;gBACb,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO;gBACrC,MAAM,EAAE,SAAS,CAAC,MAAM;aACzB,CAAC,CAAC;QAET,OAAO;YACL,IAAI,EAAE,MAAe;YACrB,YAAY,EAAE,SAAS,CAAC,IAAI;YAC5B,OAAO;SACR,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAnBW,QAAA,6BAA6B,iCAmBxC"}

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,110 @@
+{
+  "name": "rhachet-brains-fireworksai",
+  "author": "ehmpathy",
+  "description": "rhachet brain.atom adapter for fireworks ai open-source models",
+  "version": "0.0.0",
+  "repository": "ehmpathy/rhachet-brains-fireworksai",
+  "homepage": "https://github.com/ehmpathy/rhachet-brains-fireworksai",
+  "keywords": [
+    "fireworks",
+    "fireworksai",
+    "qwen",
+    "deepseek",
+    "llama",
+    "open-source",
+    "rhachet",
+    "brain",
+    "llm",
+    "ai"
+  ],
+  "bugs": "https://github.com/ehmpathy/rhachet-brains-fireworksai/issues",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "engines": {
+    "node": ">=8.0.0"
+  },
+  "files": [
+    "/dist"
+  ],
+  "dependencies": {
+    "domain-objects": "0.31.9",
+    "helpful-errors": "1.5.3",
+    "iso-price": "1.1.1",
+    "openai": "5.8.2",
+    "rhachet-artifact": "1.0.1",
+    "rhachet-artifact-git": "1.1.5",
+    "rhachet-roles-bhrain": "0.27.8",
+    "type-fns": "1.21.0",
+    "zod": "4.3.4"
+  },
+  "peerDependencies": {
+    "rhachet": ">=1.21.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.41.15",
+    "rhachet-brains-anthropic": "0.4.1",
+    "rhachet-roles-bhuild": "0.21.13",
+    "rhachet-roles-ehmpathy": "1.35.12",
+    "test-fns": "1.10.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": "npm run build && rhachet init --hooks --roles mechanic behaver driver reviewer librarian ergonomist architect reflector dreamer"
+  }
+}

package/readme.md

@@ -0,0 +1,85 @@
+# rhachet-brains-fireworksai
+
+rhachet brain.atom adapter for fireworks ai open-source models
+
+## install
+
+```sh
+npm install rhachet-brains-fireworksai
+```
+
+## usage
+
+```ts
+import { genBrainAtom } from 'rhachet-brains-fireworksai';
+import { z } from 'zod';
+
+// create a brain atom for direct model inference
+const brainAtom = genBrainAtom({ slug: 'fireworks/qwen3/coder-next' });
+
+// simple string output
+const { output: explanation } = await brainAtom.ask({
+  role: { briefs: [] },
+  prompt: 'explain this code',
+  schema: { output: z.string() },
+});
+
+// structured object output
+const { output: { summary, issues } } = await brainAtom.ask({
+  role: { briefs: [] },
+  prompt: 'analyze this code',
+  schema: { output: z.object({ summary: z.string(), issues: z.array(z.string()) }) },
+});
+```
+
+## available brains
+
+### atoms (via genBrainAtom)
+
+stateless inference without tool use.
+
+| slug | model id | context | swe-bench | input | output |
+| --- | --- | --- | --- | --- | --- |
+| `fireworks/qwen3/coder-next` | Qwen/Qwen3-Coder-Next-FP8 | 262K | 74.2% | $0.50/1M | $1.20/1M |
+| `fireworks/qwen3/coder-480b` | Qwen/Qwen3-Coder-480B-A35B-Instruct-FP8 | 262K | 69.6% | $2.00/1M | $2.00/1M |
+| `fireworks/qwen3/235b` | Qwen/Qwen3-235B-A22B-Instruct-2507-tput | 131K | — | $0.20/1M | $0.60/1M |
+| `fireworks/deepseek/v3.1` | deepseek-ai/DeepSeek-V3.1 | 128K | — | $1.25/1M | $1.25/1M |
+| `fireworks/deepseek/r1` | deepseek-ai/DeepSeek-R1 | 128K | — | $3.00/1M | $7.00/1M |
+| `fireworks/kimi/k2` | moonshotai/Kimi-K2-Instruct | 128K | — | $1.00/1M | $3.00/1M |
+| `fireworks/kimi/k2.5` | moonshotai/Kimi-K2.5 | 128K | 76.8% | $0.50/1M | $2.80/1M |
+| `fireworks/llama4/maverick` | meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8 | 1M | — | $0.27/1M | $0.85/1M |
+| `fireworks/llama3.3/70b` | meta-llama/Llama-3.3-70B-Instruct-Turbo | 128K | — | $0.88/1M | $0.88/1M |
+| `fireworks/glm/4.7` | zai-org/GLM-4.7 | 128K | 73.8% | $0.45/1M | $2.00/1M |
+
+## why fireworks ai
+
+fireworks ai rates include managed fine-tune access ($6-10/1M tokens) and high-throughput serverless infrastructure. some model authors offer cheaper direct apis for inference-only:
+
+| model | fireworks ai (in/out) | author direct (in/out) | author api |
+| --- | --- | --- | --- |
+| deepseek v3 | $1.25/$1.25 | **$0.28/$0.42** (3-4x cheaper) | [api.deepseek.com](https://api-docs.deepseek.com/quick_start/pricing) |
+| deepseek r1 | $3.00/$7.00 | **$0.28/$0.42** (10-17x cheaper) | [api.deepseek.com](https://api-docs.deepseek.com/quick_start/pricing) |
+| kimi k2 | $1.00/$3.00 | **$0.60/$2.50** (~35% cheaper) | [platform.moonshot.ai](https://platform.moonshot.ai/docs/pricing/chat) |
+| kimi k2.5 | $0.50/$2.80 | $0.60/$3.00 (at parity) | [platform.moonshot.ai](https://platform.moonshot.ai/docs/pricing/chat) |
+| qwen3 coder-next | **$0.50/$1.20** | $1.00/$5.00 (fireworks ai cheaper) | [alibabacloud.com](https://www.alibabacloud.com/help/en/model-studio/model-pricing) |
+| glm-4.7 | **$0.45/$2.00** | $0.60/$2.20 (fireworks ai cheaper) | [z.ai](https://docs.z.ai/guides/overview/pricing) |
+| llama 4 maverick | $0.27/$0.85 | ~$0.27/$0.85 (at parity) | [llama.com](https://www.llama.com/products/llama-api/) |
+
+**tldr:** deepseek's direct api is dramatically cheaper. kimi k2 is modestly cheaper via moonshot. the rest are at parity or more expensive than fireworks ai. fireworks ai's premium buys fine-tune access and unified multi-model infrastructure.
+
+## environment
+
+requires `FIREWORKS_API_KEY` environment variable.
+
+get your api key at https://api.fireworks.ai/inference/settings/api-keys
+
+## sources
+
+- [fireworks ai api docs](https://docs.fireworks.ai/reference/chat-completions-1)
+- [fireworks ai models](https://docs.fireworks.ai/docs/serverless-models)
+- [fireworks ai rates](https://fireworks.ai/pricing)
+- [deepseek rates](https://api-docs.deepseek.com/quick_start/pricing)
+- [moonshot rates](https://platform.moonshot.ai/docs/pricing/chat)
+- [alibaba model studio rates](https://www.alibabacloud.com/help/en/model-studio/model-pricing)
+- [zhipu z.ai rates](https://docs.z.ai/guides/overview/pricing)
+- [meta llama api](https://www.llama.com/products/llama-api/)