@rizom/brain 0.2.0-alpha.6 → 0.2.0-alpha.60

package/dist/index.d.ts

@@ -0,0 +1,65 @@
+/** Public brain definition contract for external authors. */
+type BrainEnvironment = Record<string, string | undefined>;
+type PluginConfig = Record<string, unknown>;
+interface Plugin {
+    readonly id: string;
+    readonly version: string;
+    readonly type: "core" | "entity" | "service" | "interface";
+    readonly packageName: string;
+    readonly description?: string;
+    readonly dependencies?: string[];
+    ready?(): Promise<void>;
+    shutdown?(): Promise<void>;
+    requiresDaemonStartup?(): boolean;
+}
+type CapabilityConfig = PluginConfig | ((env: BrainEnvironment) => PluginConfig) | undefined;
+type PluginFactory = (config: PluginConfig) => Plugin | Plugin[];
+type CapabilityEntry = [
+    id: string,
+    factory: PluginFactory,
+    config: CapabilityConfig
+];
+type InterfaceConstructor = new (config: PluginConfig) => Plugin;
+type InterfaceEntry = [
+    id: string,
+    constructor: InterfaceConstructor,
+    envMapper: (env: BrainEnvironment) => PluginConfig | null
+];
+type PresetName = "core" | "default" | "full";
+type BrainMode = "eval";
+interface BrainIdentity {
+    characterName: string;
+    role: string;
+    purpose: string;
+    values: string[];
+}
+interface BrainDefinition {
+    name: string;
+    version: string;
+    model?: string;
+    identity?: BrainIdentity;
+    agentInstructions?: string[];
+    site?: unknown;
+    theme?: string;
+    capabilities: CapabilityEntry[];
+    interfaces: InterfaceEntry[];
+    presets?: Partial<Record<PresetName, string[]>>;
+    defaultPreset?: PresetName;
+    permissions?: unknown;
+    deployment?: unknown;
+    evalDisable?: string[];
+    extra?: Record<string, unknown>;
+}
+declare function defineBrain(definition: BrainDefinition): BrainDefinition;
+
+/**
+ * Pre-v1 external plugin API marker.
+ *
+ * During alpha, the external plugin API compatibility marker tracks the
+ * published @rizom/brain package version. Once the plugin API is declared
+ * stable, this can move to an independent semver contract such as 1.0.0.
+ */
+declare const PLUGIN_API_VERSION: string;
+
+export { PLUGIN_API_VERSION, defineBrain };
+export type { BrainDefinition, BrainEnvironment, BrainIdentity, BrainMode, CapabilityConfig, CapabilityEntry, InterfaceConstructor, InterfaceEntry, Plugin, PluginConfig, PluginFactory, PresetName };

package/dist/index.js

@@ -0,0 +1,5 @@
+// @bun
+function t(i){return i}var e={name:"@rizom/brain",version:"0.2.0-alpha.60",description:"Brain runtime + CLI \u2014 scaffold, run, and manage AI brain instances",type:"module",bin:{brain:"./dist/brain.js"},exports:{".":{types:"./dist/index.d.ts",import:"./dist/index.js"},"./cli":"./dist/brain.js","./plugins":{types:"./dist/plugins.d.ts",import:"./dist/plugins.js"},"./entities":{types:"./dist/entities.d.ts",import:"./dist/entities.js"},"./services":{types:"./dist/services.d.ts",import:"./dist/services.js"},"./interfaces":{types:"./dist/interfaces.d.ts",import:"./dist/interfaces.js"},"./templates":{types:"./dist/templates.d.ts",import:"./dist/templates.js"},"./site":{types:"./dist/site.d.ts",import:"./dist/site.js"},"./themes":{types:"./dist/themes.d.ts",import:"./dist/themes.js"},"./deploy":{types:"./dist/deploy.d.ts",import:"./dist/deploy.js"},"./tsconfig.instance.json":"./tsconfig.instance.json"},files:["dist","templates","tsconfig.instance.json"],scripts:{build:"bun scripts/build.ts",prepublishOnly:"bun scripts/build.ts","dev:start":"bun dist/brain.js start",typecheck:"tsc --noEmit",test:"bun test",lint:"eslint . --ext .ts"},dependencies:{"@clack/prompts":"^0.11.0","@modelcontextprotocol/sdk":"^1.24.0","@tailwindcss/postcss":"^4.1.13","@tailwindcss/typography":"^0.5.19",postcss:"^8.5.6",preact:"^10.27.2","preact-render-to-string":"^6.3.1",tailwindcss:"^4.1.11"},optionalDependencies:{"@bitwarden/sdk-napi":"^1.0.0","@libsql/client":"^0.15.7","@tailwindcss/oxide":"^4.1.4","better-sqlite3":"^11.8.1",lightningcss:"^1.29.2","react-devtools-core":"^6.1.1",sharp:"^0.34.5"},devDependencies:{"@brains/app":"workspace:*","@brains/deploy-templates":"workspace:*","@brains/eslint-config":"workspace:*","@brains/mcp-service":"workspace:*","@brains/plugins":"workspace:*","@brains/ranger":"workspace:*","@brains/relay":"workspace:*","@brains/rover":"workspace:*","@brains/site-composition":"workspace:*","@brains/site-default":"workspace:*","@brains/site-personal":"workspace:*","@brains/site-professional":"workspace:*","@brains/theme-default":"workspace:*","@brains/theme-rizom":"workspace:*","@brains/typescript-config":"workspace:*","@brains/utils":"workspace:*","@types/bun":"latest",rollup:"^4.60.2","rollup-plugin-dts":"^6.4.1",typescript:"^5.3.3"},publishConfig:{access:"public"},repository:{type:"git",url:"https://github.com/rizom-ai/brains.git",directory:"packages/brain-cli"},license:"Apache-2.0",author:"Yeehaa <yeehaa@rizom.ai> (https://rizom.ai)",homepage:"https://github.com/rizom-ai/brains/tree/main/packages/brain-cli#readme",bugs:"https://github.com/rizom-ai/brains/issues",engines:{bun:">=1.3.3"},keywords:["brain","ai","cli","mcp","agent","personal-ai","knowledge-management"]};var n=e.version;export{t as defineBrain,n as PLUGIN_API_VERSION};
+
+//# debugId=27C888CE0CF0ED0464756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../../../shell/app/src/contracts/brain-definition.ts", "../src/plugin-api-version.ts"],
+  "sourcesContent": [
+    "/** Public brain definition contract for external authors. */\n\nexport type BrainEnvironment = Record<string, string | undefined>;\nexport type PluginConfig = Record<string, unknown>;\n\nexport interface Plugin {\n  readonly id: string;\n  readonly version: string;\n  readonly type: \"core\" | \"entity\" | \"service\" | \"interface\";\n  readonly packageName: string;\n  readonly description?: string;\n  readonly dependencies?: string[];\n  ready?(): Promise<void>;\n  shutdown?(): Promise<void>;\n  requiresDaemonStartup?(): boolean;\n}\n\nexport type CapabilityConfig =\n  | PluginConfig\n  | ((env: BrainEnvironment) => PluginConfig)\n  | undefined;\n\nexport type PluginFactory = (config: PluginConfig) => Plugin | Plugin[];\n\nexport type CapabilityEntry = [\n  id: string,\n  factory: PluginFactory,\n  config: CapabilityConfig,\n];\n\nexport type InterfaceConstructor = new (config: PluginConfig) => Plugin;\n\nexport type InterfaceEntry = [\n  id: string,\n  constructor: InterfaceConstructor,\n  envMapper: (env: BrainEnvironment) => PluginConfig | null,\n];\n\nexport type PresetName = \"core\" | \"default\" | \"full\";\nexport type BrainMode = \"eval\";\n\nexport interface BrainIdentity {\n  characterName: string;\n  role: string;\n  purpose: string;\n  values: string[];\n}\n\nexport interface BrainDefinition {\n  name: string;\n  version: string;\n  model?: string;\n  identity?: BrainIdentity;\n  agentInstructions?: string[];\n  site?: unknown;\n  theme?: string;\n  capabilities: CapabilityEntry[];\n  interfaces: InterfaceEntry[];\n  presets?: Partial<Record<PresetName, string[]>>;\n  defaultPreset?: PresetName;\n  permissions?: unknown;\n  deployment?: unknown;\n  evalDisable?: string[];\n  extra?: Record<string, unknown>;\n}\n\nexport function defineBrain(definition: BrainDefinition): BrainDefinition {\n  return definition;\n}\n",
+    "import packageJson from \"../package.json\" with { type: \"json\" };\n\n/**\n * Pre-v1 external plugin API marker.\n *\n * During alpha, the external plugin API compatibility marker tracks the\n * published @rizom/brain package version. Once the plugin API is declared\n * stable, this can move to an independent semver contract such as 1.0.0.\n */\nexport const PLUGIN_API_VERSION = packageJson.version;\n"
+  ],
+  "mappings": ";AAkEO,SAAS,CAAW,CAAC,EAA8C,CACxE,OAAO,moFC1DF,IAAM,EAAqB,EAAY",
+  "debugId": "27C888CE0CF0ED0464756E2164756E21",
+  "names": []
+}