@p-sw/brainbox 0.1.0 → 0.1.1

package/src/config/loader.ts

@@ -1,115 +0,0 @@
-import { dirname, join, resolve } from "path";
-import { z, ZodError } from "zod";
-import { homedir } from "os";
-import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
-import { mkdirSync, readFileSync, writeFileSync } from "fs";
-import { logger } from "@/utils/logger";
-
-export const brainboxRoot = process.env["BRAINBOX_ROOT_PATH"]
-  ? resolve(process.cwd(), process.env["BRAINBOX_ROOT_PATH"])
-  : join(homedir(), ".brainbox");
-
-// ponytail: add a file → call configFile(name, schema) once and you get
-// { read, write, update, path }. New writes / new files become one line each.
-// ponytail: add a key  → add it + its default to the schema. That's it.
-export interface ConfigFile<T> {
-  /** Absolute path the file lives at. Resolved at call time. */
-  path(): string;
-  /** Read + validate against the schema. Creates the file from defaults on first run. */
-  read(): T;
-  /** Write a value (will be stringified as YAML). Creates parent dirs as needed. */
-  write(value: T): void;
-  /** read → fn → write → return the new value. */
-  update(fn: (current: T) => T): T;
-}
-
-export interface ConfigFileOptions<T> {
-  schema: z.ZodType<T>;
-  /** Optional comment prepended to the file on first creation only. */
-  header?: string;
-}
-
-export function configFile<T>(
-  file: string,
-  options: ConfigFileOptions<T>,
-): ConfigFile<T> {
-  // ponytail: defer path resolution — module-load snapshot freezes BRAINBOX_ROOT_PATH.
-  const path = (): string => join(brainboxRoot, file);
-  const read = (): T => {
-    const p = path();
-    let raw: unknown;
-    try {
-      raw = parseYaml(readFileSync(p, "utf8")) ?? {};
-    } catch (err) {
-      if ((err as NodeJS.ErrnoException).code !== "ENOENT") throw err;
-      const defaults = defaultsFromSchema(options.schema);
-      const templateStr =
-        (options.header ? options.header + "\n" : "") +
-        (defaults === undefined ? "" : stringifyYaml(defaults));
-      mkdirSync(dirname(p), { recursive: true });
-      writeFileSync(p, templateStr);
-      raw = defaults ?? {};
-    }
-    try {
-      return options.schema.parse(raw);
-    } catch (err) {
-      if (err instanceof ZodError) {
-        logger.error(
-          `Invalid config in ${p}:\n` +
-            err.issues
-              .map((i) => `  ${i.path.join(".") || "(root)"}: ${i.message}`)
-              .join("\n"),
-        );
-        process.exit(1);
-      }
-      throw err;
-    }
-  };
-  const write = (value: T): void => {
-    const p = path();
-    mkdirSync(dirname(p), { recursive: true });
-    writeFileSync(p, stringifyYaml(value));
-  };
-  const update = (fn: (current: T) => T): T => {
-    const next = fn(read());
-    write(next);
-    return next;
-  };
-  return { path, read, write, update };
-}
-
-// ponytail: kept for the two call sites that don't need write access — the
-// module-load-time `config` snapshot still wants the parsed value, not a
-// handle to a lazy reader.
-export function parseConfigFile<T>(
-  file: string,
-  options: { header?: string; schema: z.ZodType<T> },
-): T {
-  return configFile(file, options).read();
-}
-
-function defaultsFromSchema(schema: z.ZodType): unknown {
-  const json = z.toJSONSchema(schema) as Record<string, unknown>;
-  return extractDefaults(json);
-}
-
-function extractDefaults(node: unknown): unknown {
-  if (!node || typeof node !== "object") return undefined;
-  const obj = node as Record<string, unknown>;
-  if ("default" in obj) return obj.default;
-  if (
-    obj.type === "object" &&
-    obj.properties &&
-    typeof obj.properties === "object"
-  ) {
-    const out: Record<string, unknown> = {};
-    for (const [k, v] of Object.entries(
-      obj.properties as Record<string, unknown>,
-    )) {
-      const d = extractDefaults(v);
-      if (d !== undefined) out[k] = d;
-    }
-    return Object.keys(out).length ? out : undefined;
-  }
-  return undefined;
-}

package/src/index.ts

@@ -1,61 +0,0 @@
-#!/usr/bin/env node
-import { Command } from "commander";
-import { readFileSync } from "fs";
-import { fileURLToPath } from "url";
-import { dirname, join } from "path";
-import { logger } from "@/utils/logger";
-import { config } from "@/config";
-import { register as daemon } from "@/commands/daemon";
-import { register as brain } from "@/commands/brain";
-import { register as pairing } from "@/commands/pairing";
-import { register as restart } from "@/commands/restart";
-import { register as auth } from "@/commands/auth";
-import { register as model } from "@/commands/model";
-import { register as onboard } from "@/commands/onboard";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// ponytail: one line to translate the user-facing `debug: true` flag in
-// brainbox.yaml into the logger's internal level. The level is the only thing
-// debug mode changes — no separate stream, no extra format.
-logger.configure({ level: config.debug ? "debug" : "info" });
-logger.debug(
-  `brainbox starting (debug=${config.debug}, root=${config.brainboxRoot})`,
-);
-
-function getVersion(): string {
-  try {
-    const pkgPath = join(__dirname, "..", "package.json");
-    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-    return pkg.version ?? "0.0.0";
-  } catch {
-    return "0.0.0";
-  }
-}
-
-const argv = process.argv;
-const program = new Command();
-
-program
-  .name("brainbox")
-  .description("A CLI tool for brainbox")
-  .version(getVersion(), "-v, --version", "Display version number")
-  .helpOption("-h, --help", "Display help for command")
-  .configureOutput({
-    outputError: (str) => logger.error(str.replace("error: ", "")),
-  });
-daemon(program);
-brain(program);
-pairing(program);
-restart(program);
-auth(program);
-model(program);
-onboard(program);
-
-program.on("command:*", () => {
-  logger.error(`Unknown command: ${program.args.join(" ")}`);
-  program.help();
-});
-
-program.parseAsync(argv);

package/src/provider/index.ts

@@ -1,122 +0,0 @@
-export {
-  LLMExecutor,
-  defaultReasoningEffort,
-  readAuthString,
-  listProviderNames,
-  type CallOptions,
-  type ChatAssistantMessage,
-  type ChatChoice,
-  type ChatFunctionTool,
-  type ChatMessages,
-  type ChatWithToolsOptions,
-  type ProviderCtor,
-  type ReasoningEffort,
-  type ToolCall,
-} from "./llm";
-
-import { LLMExecutor } from "./llm";
-import { OpenRouterExecutor } from "./providers/openrouter";
-import { OpenAIExecutor } from "./providers/openai";
-import { MistralExecutor } from "./providers/mistral";
-import { DeepSeekExecutor } from "./providers/deepseek";
-import { GroqExecutor } from "./providers/groq";
-import { CerebrasExecutor } from "./providers/cerebras";
-import { FireworksExecutor } from "./providers/fireworks";
-import { TogetherExecutor } from "./providers/together";
-import { XAIExecutor } from "./providers/xai";
-import { MoonshotExecutor } from "./providers/moonshot";
-import { NvidiaExecutor } from "./providers/nvidia";
-import { DeepInfraExecutor } from "./providers/deepinfra";
-import { Ai302Executor } from "./providers/302ai";
-import { DigitalOceanExecutor } from "./providers/digitalocean";
-import { HeliconeExecutor } from "./providers/helicone";
-import { ScalewayExecutor } from "./providers/scaleway";
-import { VeniceExecutor } from "./providers/venice";
-import { NebiusExecutor } from "./providers/nebius";
-import { OvhCloudExecutor } from "./providers/ovhcloud";
-import { StackitExecutor } from "./providers/stackit";
-import { GmiExecutor } from "./providers/gmi";
-import { ZaiExecutor } from "./providers/zai";
-import { ZenMuxExecutor } from "./providers/zenmux";
-import { MiniMaxExecutor } from "./providers/MiniMax";
-import { IoNetExecutor } from "./providers/ionet";
-import { BasetenExecutor } from "./providers/baseten";
-import { CortecsExecutor } from "./providers/cortecs";
-import { HuggingFaceExecutor } from "./providers/huggingface";
-import { LmStudioExecutor } from "./providers/lmstudio";
-import { OllamaExecutor } from "./providers/ollama";
-import { OllamaCloudExecutor } from "./providers/ollama_cloud";
-import { LlamaCppExecutor } from "./providers/llamacpp";
-import { VercelExecutor } from "./providers/vercel";
-import { LlmGatewayExecutor } from "./providers/llmgateway";
-import { CloudflareGatewayExecutor } from "./providers/cloudflare_gateway";
-import { CloudflareWorkersExecutor } from "./providers/cloudflare_workers";
-import { SapAiCoreExecutor } from "./providers/sap_aicore";
-import { AzureOpenAIExecutor } from "./providers/azure_openai";
-import { AzureCognitiveExecutor } from "./providers/azure_cognitive";
-import { AnthropicExecutor } from "./providers/anthropic";
-import { BedrockExecutor } from "./providers/bedrock";
-import { VertexExecutor } from "./providers/vertex";
-import { CopilotExecutor } from "./providers/copilot";
-import { GitLabDuoExecutor } from "./providers/gitlab_duo";
-import { SnowflakeCortexExecutor } from "./providers/snowflake_cortex";
-
-function register(
-  name: string,
-  ctor: new (opts: {
-    apiKey: string;
-    conversationModel: string;
-    identityModel: string;
-    auth?: Record<string, unknown>;
-  }) => LLMExecutor,
-): void {
-  LLMExecutor.registerProvider({ name, ctor: ctor as never });
-}
-
-register("openrouter", OpenRouterExecutor);
-register("openai", OpenAIExecutor);
-register("mistral", MistralExecutor);
-register("deepseek", DeepSeekExecutor);
-register("groq", GroqExecutor);
-register("cerebras", CerebrasExecutor);
-register("fireworks", FireworksExecutor);
-register("together", TogetherExecutor);
-register("xai", XAIExecutor);
-register("moonshot", MoonshotExecutor);
-register("nvidia", NvidiaExecutor);
-register("deepinfra", DeepInfraExecutor);
-register("302ai", Ai302Executor);
-register("digitalocean", DigitalOceanExecutor);
-register("helicone", HeliconeExecutor);
-register("scaleway", ScalewayExecutor);
-register("venice", VeniceExecutor);
-register("nebius", NebiusExecutor);
-register("ovhcloud", OvhCloudExecutor);
-register("stackit", StackitExecutor);
-register("gmi", GmiExecutor);
-register("zai", ZaiExecutor);
-register("zenmux", ZenMuxExecutor);
-register("MiniMax", MiniMaxExecutor);
-register("ionet", IoNetExecutor);
-register("baseten", BasetenExecutor);
-register("cortecs", CortecsExecutor);
-register("huggingface", HuggingFaceExecutor);
-register("lmstudio", LmStudioExecutor);
-register("ollama", OllamaExecutor);
-register("ollama-cloud", OllamaCloudExecutor);
-register("llamacpp", LlamaCppExecutor);
-register("vercel", VercelExecutor);
-register("llmgateway", LlmGatewayExecutor);
-register("cloudflare-gateway", CloudflareGatewayExecutor);
-register("cloudflare-workers", CloudflareWorkersExecutor);
-register("sap-aicore", SapAiCoreExecutor);
-register("azure-openai", AzureOpenAIExecutor);
-register("azure-cognitive", AzureCognitiveExecutor);
-register("anthropic", AnthropicExecutor);
-register("bedrock", BedrockExecutor);
-register("vertex", VertexExecutor);
-register("copilot", CopilotExecutor);
-register("gitlab-duo", GitLabDuoExecutor);
-register("snowflake-cortex", SnowflakeCortexExecutor);
-
-export const llm = LLMExecutor.init();

package/src/provider/llm.ts

@@ -1,191 +0,0 @@
-import { config } from "@/config";
-import { logger } from "@/utils/logger";
-
-const log = logger.child("llm");
-
-// --- Provider-agnostic shapes -----------------------------------------------
-
-export type ChatAssistantMessage = {
-  role: "assistant";
-  content?: string;
-  toolCalls?: ToolCall[];
-};
-
-export type ChatMessages =
-  | { role: "system"; content: string }
-  | { role: "user"; content: string }
-  | ChatAssistantMessage
-  | { role: "tool"; content: string; toolCallId: string };
-
-export type ToolCall = {
-  id: string;
-  function: { name: string; arguments: string };
-};
-
-export type ChatFunctionTool = {
-  name: string;
-  description?: string;
-  parameters?: Record<string, unknown>;
-};
-
-export type ChatChoice = {
-  message: {
-    content?: string;
-    toolCalls?: ToolCall[];
-  };
-};
-
-export type ReasoningEffort = "none" | "low" | "medium" | "high";
-
-export type CallOptions = {
-  instruction: string;
-  message: string;
-  reasoningEffort?: ReasoningEffort;
-} & (
-  | { jsonSchemaName: string; jsonSchema: Record<string, unknown> | undefined }
-  | object
-);
-
-export type ChatWithToolsOptions = {
-  instruction: string;
-  messages: ChatMessages[];
-  tools: ChatFunctionTool[];
-  reasoningEffort?: ReasoningEffort;
-  parallelToolCalls?: boolean;
-};
-
-// --- Abstract base ----------------------------------------------------------
-
-export type ProviderCtor = new (opts: {
-  apiKey: string;
-  conversationModel: string;
-  identityModel: string;
-  // ponytail: per-provider knobs (region, project, deployment, endpoint) come
-  // from the auth record and are forwarded as-is. Concrete providers read the
-  // fields they need; new providers don't require editing this signature.
-  auth?: Record<string, unknown>;
-}) => LLMExecutor;
-
-export function defaultReasoningEffort(
-  effort: ReasoningEffort | undefined,
-  model: string,
-  identityModel: string,
-): ReasoningEffort {
-  if (effort) return effort;
-  return model === identityModel ? "medium" : "none";
-}
-
-export function readAuthString(
-  auth: Record<string, unknown> | undefined,
-  key: string,
-  envName?: string,
-): string {
-  const fromAuth =
-    typeof auth?.[key] === "string" ? (auth[key] as string) : undefined;
-  if (fromAuth) return fromAuth;
-  if (envName) {
-    const fromEnv = process.env[envName];
-    if (typeof fromEnv === "string" && fromEnv.length > 0) return fromEnv;
-  }
-  return "";
-}
-
-export abstract class LLMExecutor {
-  abstract readonly providerName: string;
-  abstract readonly models: { conversation: string; identity: string };
-
-  abstract call<T>(model: string, options: CallOptions): Promise<T>;
-  abstract chatWithTools(
-    model: string,
-    options: ChatWithToolsOptions,
-  ): Promise<ChatChoice>;
-
-  // ponytail: registry + factory. Adding a provider = one registerProvider call in index.ts.
-  private static providers: Array<{ name: string; ctor: ProviderCtor }> = [];
-
-  static registerProvider(p: { name: string; ctor: ProviderCtor }): void {
-    LLMExecutor.providers.push(p);
-  }
-
-  static listProviderNames(): string[] {
-    return LLMExecutor.providers.map((p) => p.name);
-  }
-
-  private static lookup(name: string): ProviderCtor {
-    const entry = LLMExecutor.providers.find((p) => p.name === name);
-    if (!entry) {
-      log.error(
-        `init: unknown provider "${name}". Registered: ${LLMExecutor.providers.map((p) => p.name).join(", ") || "(none)"}`,
-      );
-      process.exit(1);
-    }
-    return entry.ctor;
-  }
-
-  static init(): LLMExecutor {
-    const { conversationModel, identityModel, auth } = config;
-    const parseSlot = (slot: string): { provider: string; model: string } => {
-      const slash = slot.indexOf("/");
-      if (slash < 0) {
-        log.error(
-          `init: model slot "${slot}" must be in "provider/model" form`,
-        );
-        process.exit(1);
-      }
-      return { provider: slot.slice(0, slash), model: slot.slice(slash + 1) };
-    };
-    const conv = parseSlot(conversationModel);
-    const id = parseSlot(identityModel);
-    const build = (providerName: string): LLMExecutor => {
-      const ctor = LLMExecutor.lookup(providerName);
-      const providerAuth = (auth[providerName] ?? {}) as Record<
-        string,
-        unknown
-      >;
-      return new ctor({
-        apiKey: (providerAuth["apiKey"] as string) ?? "",
-        conversationModel: conv.model,
-        identityModel: id.model,
-        auth: providerAuth,
-      });
-    };
-
-    if (conv.provider === id.provider) {
-      return build(conv.provider);
-    }
-
-    const modelToProvider: Record<string, string> = {
-      [conv.model]: conv.provider,
-      [id.model]: id.provider,
-    };
-    const instances: Record<string, LLMExecutor> = {
-      [conv.provider]: build(conv.provider),
-      [id.provider]: build(id.provider),
-    };
-    const fallback = instances[conv.provider]!;
-
-    return new (class extends LLMExecutor {
-      readonly providerName = "dispatch";
-      readonly models = {
-        conversation: conv.model,
-        identity: id.model,
-      };
-      call<T>(model: string, options: CallOptions): Promise<T> {
-        const exec = instances[modelToProvider[model] ?? ""] ?? fallback;
-        return exec.call<T>(model, options);
-      }
-      chatWithTools(model: string, options: ChatWithToolsOptions) {
-        const exec = instances[modelToProvider[model] ?? ""] ?? fallback;
-        return exec.chatWithTools(model, options);
-      }
-    })();
-  }
-}
-
-
-// ponytail: thin wrapper so callers can `import { listProviderNames }`
-// without going through the class — static class members aren't a top-level
-// binding under `verbatimModuleSyntax`.
-export function listProviderNames(): string[] {
-  return LLMExecutor.listProviderNames();
-}

package/src/provider/promptLoader.ts

@@ -1,36 +0,0 @@
-import { readFile } from "fs/promises";
-import path, { dirname } from "path";
-import { fileURLToPath } from "url";
-import { logger } from "@/utils/logger";
-
-const log = logger.child("prompt-loader");
-
-const prompts = [
-  "PERSONA_INIT",
-  "PERSONA_BASE_SYSTEM_PROMPT",
-  "PERSONA_BASE_SYSTEM_PROMPT_FIXED",
-  "DAILY_SCHEDULE",
-  "MONTHLY_SCHEDULE",
-  "SCHEDULE_AVAILABILITY",
-  "OBJECTIFIER",
-  "SEND_MESSAGE",
-  "START_CONVERSATION",
-  "MEMOIR",
-] as const;
-export type PromptKey = (typeof prompts)[number];
-
-function fileName(promptKey: PromptKey): string {
-  return promptKey.toLowerCase() + ".md";
-}
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const PROMPTS_DIR = path.resolve(__dirname, "../../prompts");
-
-export async function loadPrompt(promptKey: PromptKey): Promise<string> {
-  const filePath = path.join(PROMPTS_DIR, fileName(promptKey));
-  log.debug(`loadPrompt: ${promptKey} (${filePath})`);
-  const content = await readFile(filePath, "utf-8");
-  log.debug(`loadPrompt: ${promptKey} → ${content.length} chars`);
-  return content;
-}

package/src/provider/providers/302ai.ts

@@ -1,17 +0,0 @@
-import { OpenAICompatibleExecutor } from "./openai_compatible";
-
-export class Ai302Executor extends OpenAICompatibleExecutor {
-  constructor(opts: {
-    apiKey: string;
-    conversationModel: string;
-    identityModel: string;
-  }) {
-    super({
-      providerName: "302ai",
-      baseURL: "https://api.302.ai/v1",
-      apiKey: opts.apiKey,
-      conversationModel: opts.conversationModel,
-      identityModel: opts.identityModel,
-    });
-  }
-}

package/src/provider/providers/MiniMax.ts

@@ -1,17 +0,0 @@
-import { OpenAICompatibleExecutor } from "./openai_compatible";
-
-export class MiniMaxExecutor extends OpenAICompatibleExecutor {
-  constructor(opts: {
-    apiKey: string;
-    conversationModel: string;
-    identityModel: string;
-  }) {
-    super({
-      providerName: "MiniMax",
-      baseURL: "https://api.MiniMax.chat/v1",
-      apiKey: opts.apiKey,
-      conversationModel: opts.conversationModel,
-      identityModel: opts.identityModel,
-    });
-  }
-}