@sesamespace/hivemind 0.4.2 → 0.4.3

package/dist/README.md

@@ -0,0 +1,116 @@
+# Hivemind
+
+Cognitive architecture for AI agents with multi-layered memory, context isolation, and multi-machine fleet distribution.
+
+## Quick Start
+
+### One-Command Install (recommended)
+
+```bash
+curl -sL api.sesame.space/api/v1/hivemind/install | bash -s -- <your-sesame-api-key>
+```
+
+This installs all dependencies, configures the agent from Sesame, and starts it.
+
+### Manual Install
+
+```bash
+# Install the CLI
+npm install -g @sesamespace/hivemind
+
+# Initialize from your Sesame API key
+hivemind init <your-sesame-api-key>
+
+# Start the agent
+hivemind start --config config/default.toml
+
+# (Optional) Install as a service that survives reboots
+hivemind service install
+```
+
+### Development Install
+
+```bash
+git clone https://github.com/baileydavis2026/hivemind.git
+cd hivemind
+pnpm install
+pnpm build
+cd packages/memory && cargo build --release && cd ../..
+```
+
+## What You Need
+
+- **macOS** (Apple Silicon recommended)
+- **Sesame API key** — get one at [sesame.space](https://sesame.space)
+- **OpenRouter API key** — get one at [openrouter.ai](https://openrouter.ai) (or provision via Sesame vault)
+
+## Architecture
+
+```
+┌─────────────────────────────────────────┐
+│  Agent Runtime (TypeScript)              │
+│  ├── Sesame WebSocket (messaging)        │
+│  ├── Context Manager (project isolation) │
+│  ├── LLM Client (OpenRouter)             │
+│  └── Memory Client                       │
+│       └── Memory Daemon (Rust/LanceDB)   │
+│            └── Ollama (embeddings)        │
+└─────────────────────────────────────────┘
+```
+
+### Memory Layers
+
+| Layer | Name | Purpose |
+|-------|------|---------|
+| L1 | Working Memory | Current conversation (in-memory) |
+| L2 | Episodic Memory | All interactions (LanceDB vectors) |
+| L3 | Semantic Memory | Promoted knowledge (high-access patterns) |
+| L4 | External Memory | Git, files, APIs (on-demand) |
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `hivemind init <key>` | Initialize agent from Sesame API key |
+| `hivemind start` | Start the agent |
+| `hivemind service install` | Install as launchd service (auto-start on boot) |
+| `hivemind service status` | Check service status |
+| `hivemind service logs` | View recent logs |
+| `hivemind service uninstall` | Remove launchd services |
+| `hivemind fleet` | Manage worker fleet |
+
+## Configuration
+
+Config is layered (later overrides earlier):
+
+1. `config/default.toml` — shipped defaults
+2. `config/local.toml` — generated by `hivemind init`
+3. `.env` — secrets (SESAME_API_KEY, LLM_API_KEY, AGENT_NAME)
+4. Environment variables — override everything
+
+## Team Charter
+
+Agent behavior in group chats is governed by `config/TEAM-CHARTER.md`. Edit it to change how agents interact in shared spaces. Changes take effect on agent restart.
+
+## Development
+
+```bash
+pnpm install          # Install deps
+pnpm build            # Build all packages
+
+# Run tests (49 total)
+npx tsx packages/runtime/src/__tests__/fleet.test.ts
+npx tsx packages/runtime/src/__tests__/integration.test.ts
+npx tsx packages/runtime/src/__tests__/fleet-integration.test.ts
+```
+
+## Publishing
+
+```bash
+./scripts/build-npm.sh                    # Build flat npm package
+cd dist/npm && npm publish --access public  # Publish to npm
+```
+
+## License
+
+Private — Big Canyon Farms

package/dist/{chunk-RXCV57H3.js → chunk-CGSXJVSS.js}

@@ -1,6 +1,6 @@
 import {
   FleetManager
-} from "./chunk-YEOAEJ62.js";
+} from "./chunk-S3RVZBPZ.js";
 
 // packages/cli/src/commands/fleet.ts
 function formatUptime(seconds) {
@@ -183,4 +183,4 @@ Commands:
 export {
   runFleetCommand
 };
-//# sourceMappingURL=chunk-RXCV57H3.js.map
+//# sourceMappingURL=chunk-CGSXJVSS.js.map

package/dist/{chunk-OQ272HKA.js → chunk-O257FXSX.js}

@@ -1,6 +1,6 @@
 import {
   startPipeline
-} from "./chunk-LRK64BAK.js";
+} from "./chunk-YHRGEWAZ.js";
 
 // packages/cli/src/commands/start.ts
 import { resolve } from "path";
@@ -41,4 +41,4 @@ Options:
 export {
   runStartCommand
 };
-//# sourceMappingURL=chunk-OQ272HKA.js.map
+//# sourceMappingURL=chunk-O257FXSX.js.map

package/dist/{chunk-YEOAEJ62.js → chunk-S3RVZBPZ.js}

@@ -4,7 +4,7 @@ import {
   HEALTH_TIMEOUT_MS,
   PRIMARY_ROUTES,
   WORKER_ROUTES
-} from "./chunk-LRK64BAK.js";
+} from "./chunk-YHRGEWAZ.js";
 
 // packages/runtime/src/fleet/primary-client.ts
 var PrimaryClient = class {
@@ -728,4 +728,4 @@ export {
   WorkerMemorySync,
   PrimaryMemorySync
 };
-//# sourceMappingURL=chunk-YEOAEJ62.js.map
+//# sourceMappingURL=chunk-S3RVZBPZ.js.map