@polderlabs/bizar-dash 3.0.0

package/templates/mod/FORMAT.md

@@ -0,0 +1,76 @@
+# Bizar Mods — Format Reference (v3.0.0)
+
+A mod is a folder with a `mod.json` manifest that extends the Bizar
+platform. Mods live at `~/.config/bizar/mods/<mod-id>/`.
+
+## Folder layout
+
+```
+<mod-id>/
+├── mod.json           # manifest (required)
+├── README.md          # description (optional)
+├── agents/            # custom agents (optional)
+│   └── <agent>.md
+├── commands/          # custom commands (optional)
+│   └── <command>.md
+├── routes/            # custom API routes (optional)
+│   └── <route>.mjs
+├── views/             # custom React views (optional)
+│   └── <view>.tsx
+├── web/               # custom web assets (optional)
+│   └── index.html
+├── tui/               # custom TUI components (optional)
+│   └── <comp>.mjs
+└── hooks/             # custom event hooks (optional)
+    └── <hook>.mjs
+```
+
+## mod.json schema
+
+```json
+{
+  "id": "my-mod",
+  "name": "My Mod",
+  "version": "1.0.0",
+  "author": "name",
+  "description": "...",
+  "bizar": ">=3.0.0",
+  "type": "agent" | "command" | "view" | "route" | "tui" | "full",
+  "enabled": true,
+  "permissions": ["read:agents", "write:tasks"],
+  "entry": {
+    "agent": "agents/my-agent.md",
+    "command": "commands/my-command.md",
+    "route": "routes/my-route.mjs",
+    "view": "views/my-view.tsx",
+    "tui": "tui/my-comp.mjs"
+  }
+}
+```
+
+## Permissions (v3.0.0)
+
+`permissions` is a hint to the user. v3 doesn't enforce it yet — the
+runtime is permissive. Future versions will gate operations by
+permission.
+
+Common permission strings:
+- `read:agents`
+- `write:agents`
+- `read:tasks`
+- `write:tasks`
+- `read:projects`
+- `write:projects`
+- `read:schedules`
+- `write:schedules`
+- `read:config`
+- `write:config`
+
+## Lifecycle
+
+- The dashboard scans `~/.config/bizar/mods/` on startup.
+- For each mod with `enabled: true`, the loader exposes its agents,
+  commands, and views in the dashboard.
+- v3 doesn't dynamically mount mod routes or render mod views — those
+  are planned for v3.1+. Mods that ship today can still install custom
+  agents and commands.

package/templates/mod/hello-mod/README.md

@@ -0,0 +1,19 @@
+# Hello Mod
+
+A sample mod that ships with the Bizar platform. It demonstrates:
+
+- A `mod.json` manifest with permissions and an `entry` block
+- A sample agent (`agents/greeter.md`)
+- A slash command (`commands/hello.md`)
+- A route module (`routes/ping.mjs`) — the v3.1+ runtime will mount it
+- A view metadata file (`views/HelloView.tsx`) — the v3.1+ dashboard
+  will render it as a tab
+
+## Install
+
+```bash
+# from the bizarre-dash package root
+bizar-dash mod install ./templates/mod/hello-mod
+```
+
+Or copy the folder into `~/.config/bizar/mods/hello-mod/` by hand.

package/templates/mod/hello-mod/agents/greeter.md

@@ -0,0 +1,8 @@
+---
+description: Greets the user with a friendly hello.
+mode: subagent
+model: anthropic/claude-3-5-sonnet
+---
+
+You are a friendly greeter. When invoked, respond with a warm hello and
+ask the user how you can help. Keep it short and friendly.

package/templates/mod/hello-mod/commands/hello.md

@@ -0,0 +1,6 @@
+---
+description: Say hello from the Hello Mod
+---
+
+Greet the user. Print a friendly hello and remind them that the
+Hello Mod is loaded.

package/templates/mod/hello-mod/mod.json

@@ -0,0 +1,20 @@
+{
+  "id": "hello-mod",
+  "name": "Hello Mod",
+  "version": "1.0.0",
+  "author": "Bizar",
+  "description": "A sample mod that adds a /hello slash command, a Hello view tab, and a sample agent.",
+  "bizar": ">=3.0.0",
+  "type": "full",
+  "enabled": true,
+  "permissions": [
+    "read:agents",
+    "read:commands"
+  ],
+  "entry": {
+    "agent": "agents/greeter.md",
+    "command": "commands/hello.md",
+    "view": "views/HelloView.tsx"
+  },
+  "installedAt": null
+}

package/templates/mod/hello-mod/routes/ping.mjs

@@ -0,0 +1,9 @@
+// Sample route registration for the Hello Mod.
+// v3 doesn't dynamically mount mod routes yet, but this file documents
+// the intended shape for v3.1+.
+
+export default function register({ app, state }) {
+  app.get('/api/mods/hello-mod/ping', (req, res) => {
+    res.json({ ok: true, from: 'hello-mod', ts: Date.now() });
+  });
+}

package/templates/mod/hello-mod/views/HelloView.tsx

@@ -0,0 +1,10 @@
+// Sample view metadata for the Hello Mod.
+// v3 doesn't dynamically mount mod views yet, but this file documents
+// the intended shape for v3.1+.
+
+export default {
+  id: 'hello',
+  label: 'Hello',
+  icon: 'Sparkles',
+  component: 'HelloView',
+};

package/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noFallthroughCasesInSwitch": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "allowSyntheticDefaultImports": true,
+    "useDefineForClassFields": true,
+    "types": ["node"]
+  },
+  "include": ["src/web/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/vite.config.ts

@@ -0,0 +1,24 @@
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+export default defineConfig({
+  plugins: [react()],
+  root: resolve(__dirname, 'src/web'),
+  base: './',
+  build: {
+    outDir: resolve(__dirname, 'dist'),
+    emptyOutDir: true,
+    sourcemap: true,
+    rollupOptions: {
+      input: resolve(__dirname, 'src/web/index.html'),
+    },
+  },
+  server: {
+    port: 5174,
+    strictPort: false,
+  },
+});