@sesamespace/hivemind 0.5.4 → 0.5.5

package/packages/runtime/src/memory-client.ts

@@ -1,309 +0,0 @@
-import type { MemoryConfig } from "./config.js";
-
-export interface Episode {
-  id: string;
-  timestamp: string;
-  context_name: string;
-  role: string;
-  content: string;
-  access_count?: number;
-  layer?: string;
-}
-
-export interface ScoredEpisode {
-  id: string;
-  timestamp: string;
-  context_name: string;
-  role: string;
-  content: string;
-  score: number;
-  source_context?: string;
-}
-
-export interface EpisodeInput {
-  context_name?: string;
-  role: string;
-  content: string;
-}
-
-export interface ContextInfo {
-  name: string;
-  description: string;
-  created_at: string;
-  episode_count: number;
-}
-
-export interface CrossContextResult {
-  context: string;
-  episodes: ScoredEpisode[];
-}
-
-export interface PromotionResult {
-  promoted_count: number;
-  episode_ids: string[];
-}
-
-export interface TaskRecord {
-  id: string;
-  context_name: string;
-  title: string;
-  description: string;
-  status: "planned" | "active" | "complete" | "archived";
-  blocked_by: string[];
-  created_at: string;
-  updated_at: string;
-}
-
-export interface L3Entry {
-  id: string;
-  source_episode_id: string;
-  context_name: string;
-  content: string;
-  promoted_at: string;
-  access_count: number;
-  connection_density: number;
-}
-
-export interface TaskInput {
-  context_name: string;
-  title: string;
-  description: string;
-  status?: string;
-  blocked_by?: string[];
-}
-
-export class MemoryClient {
-  private baseUrl: string;
-  private topK: number;
-
-  constructor(config: MemoryConfig) {
-    this.baseUrl = config.daemon_url;
-    this.topK = config.top_k;
-  }
-
-  async storeEpisode(input: EpisodeInput): Promise<Episode> {
-    const resp = await fetch(`${this.baseUrl}/episodes`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(input),
-    });
-
-    if (!resp.ok) {
-      throw new Error(`Memory store failed: ${resp.status} ${await resp.text()}`);
-    }
-
-    return resp.json() as Promise<Episode>;
-  }
-
-  async search(query: string, context?: string, limit?: number): Promise<ScoredEpisode[]> {
-    const params = new URLSearchParams({ q: query });
-    if (context) params.set("context", context);
-    params.set("limit", String(limit ?? this.topK));
-
-    const resp = await fetch(`${this.baseUrl}/search?${params}`);
-
-    if (!resp.ok) {
-      throw new Error(`Memory search failed: ${resp.status} ${await resp.text()}`);
-    }
-
-    const data = (await resp.json()) as { episodes: ScoredEpisode[] };
-    return data.episodes;
-  }
-
-  async getContext(name: string): Promise<Episode[]> {
-    const resp = await fetch(`${this.baseUrl}/contexts/${encodeURIComponent(name)}`);
-
-    if (!resp.ok) {
-      throw new Error(`Get context failed: ${resp.status} ${await resp.text()}`);
-    }
-
-    return resp.json() as Promise<Episode[]>;
-  }
-
-  async createContext(name: string, description = ""): Promise<void> {
-    const resp = await fetch(`${this.baseUrl}/contexts`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ name, description }),
-    });
-
-    if (!resp.ok) {
-      throw new Error(`Create context failed: ${resp.status} ${await resp.text()}`);
-    }
-  }
-
-  async deleteContext(name: string): Promise<void> {
-    const resp = await fetch(`${this.baseUrl}/contexts/${encodeURIComponent(name)}`, {
-      method: "DELETE",
-    });
-
-    if (!resp.ok) {
-      throw new Error(`Delete context failed: ${resp.status} ${await resp.text()}`);
-    }
-  }
-
-  async listContexts(): Promise<ContextInfo[]> {
-    const resp = await fetch(`${this.baseUrl}/contexts`);
-
-    if (!resp.ok) {
-      throw new Error(`List contexts failed: ${resp.status} ${await resp.text()}`);
-    }
-
-    const data = (await resp.json()) as { contexts: ContextInfo[] };
-    return data.contexts;
-  }
-
-  async searchCrossContext(query: string, limit?: number): Promise<CrossContextResult[]> {
-    const params = new URLSearchParams({ q: query });
-    params.set("limit", String(limit ?? this.topK));
-
-    const resp = await fetch(`${this.baseUrl}/search/cross-context?${params}`);
-
-    if (!resp.ok) {
-      throw new Error(`Cross-context search failed: ${resp.status} ${await resp.text()}`);
-    }
-
-    const data = (await resp.json()) as { results: CrossContextResult[] };
-    return data.results;
-  }
-
-  async shareEpisode(episodeId: string, targetContext: string): Promise<void> {
-    const resp = await fetch(`${this.baseUrl}/episodes/${encodeURIComponent(episodeId)}/share`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ target_context: targetContext }),
-    });
-
-    if (!resp.ok) {
-      throw new Error(`Share episode failed: ${resp.status} ${await resp.text()}`);
-    }
-  }
-
-  async runPromotion(contextName?: string): Promise<PromotionResult> {
-    const params = new URLSearchParams();
-    if (contextName) params.set("context", contextName);
-
-    const resp = await fetch(`${this.baseUrl}/promotion/run?${params}`, {
-      method: "POST",
-    });
-
-    if (!resp.ok) {
-      throw new Error(`Promotion failed: ${resp.status} ${await resp.text()}`);
-    }
-
-    return resp.json() as Promise<PromotionResult>;
-  }
-
-  async getL3Knowledge(contextName: string): Promise<L3Entry[]> {
-    const resp = await fetch(
-      `${this.baseUrl}/promotion/l3?context=${encodeURIComponent(contextName)}`,
-    );
-
-    if (!resp.ok) {
-      throw new Error(`Get L3 failed: ${resp.status} ${await resp.text()}`);
-    }
-
-    const data = (await resp.json()) as { entries: L3Entry[] };
-    return data.entries;
-  }
-
-  async setContextScoring(contextName: string, halfLifeHours: number): Promise<void> {
-    const resp = await fetch(
-      `${this.baseUrl}/contexts/${encodeURIComponent(contextName)}/scoring`,
-      {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ half_life_hours: halfLifeHours }),
-      },
-    );
-
-    if (!resp.ok) {
-      throw new Error(`Set scoring failed: ${resp.status} ${await resp.text()}`);
-    }
-  }
-
-  async recordAccess(episodeId: string): Promise<void> {
-    const resp = await fetch(`${this.baseUrl}/episodes/${encodeURIComponent(episodeId)}/access`, {
-      method: "POST",
-    });
-
-    if (!resp.ok) {
-      throw new Error(`Record access failed: ${resp.status} ${await resp.text()}`);
-    }
-  }
-
-  async recordCoAccess(episodeIds: string[]): Promise<void> {
-    const resp = await fetch(`${this.baseUrl}/episodes/co-access`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ episode_ids: episodeIds }),
-    });
-
-    if (!resp.ok) {
-      throw new Error(`Co-access failed: ${resp.status} ${await resp.text()}`);
-    }
-  }
-
-  // Task engine methods
-  async createTask(input: TaskInput): Promise<TaskRecord> {
-    const resp = await fetch(`${this.baseUrl}/tasks`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(input),
-    });
-
-    if (!resp.ok) {
-      throw new Error(`Create task failed: ${resp.status} ${await resp.text()}`);
-    }
-
-    return resp.json() as Promise<TaskRecord>;
-  }
-
-  async listTasks(contextName: string, status?: string): Promise<TaskRecord[]> {
-    const params = new URLSearchParams({ context: contextName });
-    if (status) params.set("status", status);
-
-    const resp = await fetch(`${this.baseUrl}/tasks?${params}`);
-
-    if (!resp.ok) {
-      throw new Error(`List tasks failed: ${resp.status} ${await resp.text()}`);
-    }
-
-    const data = (await resp.json()) as { tasks: TaskRecord[] };
-    return data.tasks;
-  }
-
-  async updateTask(taskId: string, updates: Partial<Pick<TaskRecord, "status" | "title" | "description" | "blocked_by">>): Promise<TaskRecord> {
-    const resp = await fetch(`${this.baseUrl}/tasks/${encodeURIComponent(taskId)}`, {
-      method: "PATCH",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(updates),
-    });
-
-    if (!resp.ok) {
-      throw new Error(`Update task failed: ${resp.status} ${await resp.text()}`);
-    }
-
-    return resp.json() as Promise<TaskRecord>;
-  }
-
-  async getNextTask(contextName: string): Promise<TaskRecord | null> {
-    const resp = await fetch(`${this.baseUrl}/tasks/next?context=${encodeURIComponent(contextName)}`);
-
-    if (!resp.ok) {
-      if (resp.status === 404) return null;
-      throw new Error(`Get next task failed: ${resp.status} ${await resp.text()}`);
-    }
-
-    return resp.json() as Promise<TaskRecord>;
-  }
-
-  async healthCheck(): Promise<boolean> {
-    try {
-      const resp = await fetch(`${this.baseUrl}/health`);
-      return resp.ok;
-    } catch {
-      return false;
-    }
-  }
-}

package/packages/runtime/src/pipeline.ts

@@ -1,187 +0,0 @@
-import { execSync } from "child_process";
-import { Agent } from "./agent.js";
-import type { HivemindConfig } from "./config.js";
-import { loadConfig } from "./config.js";
-import { SesameClient } from "./sesame.js";
-import type { UpgradeRequest } from "./sesame.js";
-import { MemoryClient } from "./memory-client.js";
-
-export async function startPipeline(configPath: string): Promise<void> {
-  const config = loadConfig(configPath);
-
-  console.log(`[hivemind] Starting ${config.agent.name} (pid ${process.pid})`);
-
-  // Verify memory daemon is reachable
-  const memory = new MemoryClient(config.memory);
-  const memoryOk = await memory.healthCheck();
-  if (!memoryOk) {
-    console.warn("[hivemind] Memory daemon unreachable at", config.memory.daemon_url);
-    console.warn("[hivemind] Continuing without persistent memory — episodes will not be stored");
-  } else {
-    console.log("[hivemind] Memory daemon connected");
-  }
-
-  // Create the agent
-  const agent = new Agent(config);
-  console.log(`[hivemind] Context manager initialized (active: ${agent.getActiveContext()})`);
-
-  // Connect to Sesame if configured
-  if (config.sesame.api_key) {
-    await startSesameLoop(config, agent);
-  } else {
-    console.log("[hivemind] No Sesame API key configured — running in stdin mode");
-    await startStdinLoop(agent);
-  }
-}
-
-async function startSesameLoop(config: HivemindConfig, agent: Agent): Promise<void> {
-  const sesame = new SesameClient(config.sesame);
-
-  // --- Graceful shutdown ---
-  let shuttingDown = false;
-  const shutdown = (signal: string) => {
-    if (shuttingDown) return;
-    shuttingDown = true;
-    console.log(`\n[hivemind] Received ${signal}, shutting down...`);
-    try {
-      sesame.updatePresence("offline", { emoji: "⭘" });
-      sesame.disconnect();
-      console.log("[hivemind] Sesame disconnected cleanly");
-    } catch (err) {
-      console.error("[hivemind] Error during disconnect:", (err as Error).message);
-    }
-    process.exit(0);
-  };
-  process.on("SIGTERM", () => shutdown("SIGTERM"));
-  process.on("SIGINT", () => shutdown("SIGINT"));
-
-  // ── Native upgrade handler (no LLM involved) ──
-  sesame.onUpgrade(async (req: UpgradeRequest) => {
-    console.log(`[hivemind] Upgrade requested: ${req.packageName}@${req.targetVersion} (by ${req.requestedBy})`);
-    sesame.updatePresence("working", { detail: `Upgrading to ${req.targetVersion}`, emoji: "⬆️" });
-
-    try {
-      const target = req.targetVersion === "latest"
-        ? req.packageName
-        : `${req.packageName}@${req.targetVersion}`;
-
-      console.log(`[hivemind] Running: npm install -g ${target}`);
-      execSync(`npm install -g ${target}`, { stdio: "inherit", timeout: 120_000 });
-      console.log("[hivemind] Package updated successfully");
-
-      // Send confirmation message to the requesting human's DM
-      // (For now, log it — we'd need the human's channel ID for a proper message)
-      console.log(`[hivemind] Upgrade to ${req.targetVersion} complete. Restarting...`);
-
-      sesame.updatePresence("working", { detail: "Restarting after upgrade", emoji: "🔄" });
-
-      // Graceful restart — try launchd kickstart, fall back to process.exit
-      try {
-        execSync("launchctl kickstart -k gui/$(id -u)/com.hivemind.agent", { timeout: 10_000 });
-      } catch {
-        // If launchd isn't managing us, just exit (the wrapper script will restart)
-        console.log("[hivemind] Exiting for restart...");
-        process.exit(0);
-      }
-    } catch (err) {
-      console.error(`[hivemind] Upgrade failed: ${(err as Error).message}`);
-      sesame.updatePresence("online", { detail: "Upgrade failed", emoji: "❌" });
-    }
-  });
-
-  sesame.onMessage(async (msg) => {
-    if (shuttingDown) return;
-    console.log(`[sesame] ${msg.author.handle} (${msg.channelKind}): ${msg.content}`);
-
-    // Start typing indicator + set presence to thinking
-    sesame.startTyping(msg.channelId);
-    sesame.updatePresence("thinking", { detail: `Replying to ${msg.author.handle}`, emoji: "💭" });
-
-    try {
-      // Prepend sender info so the agent knows who's talking
-      const prefix = msg.channelKind === "group"
-        ? `[${msg.author.handle} in group chat]: `
-        : `[${msg.author.handle}]: `;
-      const response = await agent.processMessage(prefix + msg.content);
-
-      // Stop typing before sending reply
-      sesame.stopTyping(msg.channelId);
-
-      // Agent chose not to respond (group chat etiquette)
-      if (response.content.trim() === "__SKIP__") {
-        console.log(`[sesame] ${config.agent.name}: skipped (${msg.author.handle} in ${msg.channelKind})`);
-        sesame.updatePresence("online", { emoji: "🟢" });
-        return;
-      }
-
-      const ctxPrefix = response.contextSwitched
-        ? `[switched to ${response.context}] `
-        : "";
-      await sesame.sendMessage(msg.channelId, ctxPrefix + response.content);
-      console.log(`[sesame] ${config.agent.name} (${response.context}): ${response.content.slice(0, 100)}...`);
-
-      // Back to online
-      sesame.updatePresence("online", { emoji: "🟢" });
-    } catch (err) {
-      sesame.stopTyping(msg.channelId);
-      sesame.updatePresence("online", { emoji: "🟢" });
-      console.error("[sesame] Error processing message:", (err as Error).message);
-    }
-  });
-
-  await sesame.connect();
-  console.log("[hivemind] Listening for Sesame messages");
-
-  // Keep alive
-  await new Promise<void>(() => {});
-}
-
-async function startStdinLoop(agent: Agent): Promise<void> {
-  const readline = await import("readline");
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  });
-
-  console.log("[hivemind] Ready. Type a message (Ctrl+C to exit)");
-  console.log("[hivemind] Commands: 'switch to <name>', 'list contexts', 'create context <name>'\n");
-
-  rl.on("line", async (line: string) => {
-    const input = line.trim();
-    if (!input) return;
-
-    if (input.toLowerCase() === "list contexts") {
-      const contexts = agent.getContextManager().listContexts();
-      console.log("\nContexts:");
-      for (const ctx of contexts) {
-        const active = ctx.name === agent.getActiveContext() ? " (active)" : "";
-        console.log(`  - ${ctx.name}${active}: ${ctx.description || "(no description)"}`);
-      }
-      console.log();
-      return;
-    }
-
-    const createMatch = input.match(/^create context (\S+)\s*(.*)?$/i);
-    if (createMatch) {
-      const name = createMatch[1];
-      const desc = createMatch[2] || "";
-      await agent.getContextManager().createContext(name, desc);
-      console.log(`\nCreated context: ${name}\n`);
-      return;
-    }
-
-    try {
-      const response = await agent.processMessage(input);
-      if (response.contextSwitched) {
-        console.log(`\n[switched to context: ${response.context}]`);
-      }
-      console.log(`\n${response.content}\n`);
-    } catch (err) {
-      console.error("Error:", (err as Error).message);
-    }
-  });
-
-  return new Promise((resolve) => {
-    rl.on("close", resolve);
-  });
-}

package/packages/runtime/src/prompt.ts

@@ -1,173 +0,0 @@
-import { readFileSync, existsSync, readdirSync } from "fs";
-import { resolve, basename } from "path";
-import type { AgentConfig } from "./config.js";
-import type { ChatMessage } from "./llm-client.js";
-import type { ScoredEpisode, L3Entry } from "./memory-client.js";
-
-// Cache loaded charter to avoid re-reading every message
-let charterCache: { path: string; content: string } | null = null;
-
-function loadCharter(path: string): string {
-  if (charterCache && charterCache.path === path) return charterCache.content;
-  if (!existsSync(path)) return "";
-  const content = readFileSync(path, "utf-8");
-  charterCache = { path, content };
-  return content;
-}
-
-// ── Workspace file loading ──
-// These are identity/config files loaded once from disk into the system prompt.
-// They don't consume conversation tokens — they're part of the static system prompt.
-
-// Priority order for workspace files (loaded in this order)
-const WORKSPACE_FILE_PRIORITY = [
-  "SOUL.md",       // Who the agent is (personality, values)
-  "IDENTITY.md",   // Name, avatar, creature type
-  "AGENTS.md",     // Operating instructions
-  "USER.md",       // About the human(s)
-  "TOOLS.md",      // Tool-specific notes
-];
-
-interface WorkspaceFiles {
-  dir: string;
-  files: Map<string, string>; // filename -> content
-  loadedAt: number;
-}
-
-let workspaceCache: WorkspaceFiles | null = null;
-const WORKSPACE_CACHE_TTL_MS = 60_000; // Reload every 60s
-
-function loadWorkspaceFiles(dir: string): Map<string, string> {
-  const now = Date.now();
-  if (workspaceCache && workspaceCache.dir === dir && (now - workspaceCache.loadedAt) < WORKSPACE_CACHE_TTL_MS) {
-    return workspaceCache.files;
-  }
-
-  const files = new Map<string, string>();
-  if (!existsSync(dir)) return files;
-
-  // Load priority files first
-  for (const filename of WORKSPACE_FILE_PRIORITY) {
-    const filePath = resolve(dir, filename);
-    if (existsSync(filePath)) {
-      try {
-        files.set(filename, readFileSync(filePath, "utf-8"));
-      } catch {
-        // Skip unreadable files
-      }
-    }
-  }
-
-  // Load any other .md files not in the priority list
-  try {
-    const entries = readdirSync(dir);
-    for (const entry of entries) {
-      if (entry.endsWith(".md") && !files.has(entry) && !entry.startsWith(".")) {
-        const filePath = resolve(dir, entry);
-        try {
-          files.set(entry, readFileSync(filePath, "utf-8"));
-        } catch {
-          // Skip
-        }
-      }
-    }
-  } catch {
-    // Skip if dir can't be read
-  }
-
-  workspaceCache = { dir, files, loadedAt: now };
-  const names = [...files.keys()].join(", ");
-  if (files.size > 0) {
-    console.log(`[workspace] Loaded ${files.size} files: ${names}`);
-  }
-  return files;
-}
-
-export function buildSystemPrompt(
-  config: AgentConfig,
-  episodes: ScoredEpisode[],
-  contextName = "global",
-  l3Knowledge: L3Entry[] = [],
-): string {
-  let prompt = `You are ${config.name}. ${config.personality}\n`;
-
-  // Load workspace identity files (SOUL.md, IDENTITY.md, AGENTS.md, etc.)
-  // These are loaded from disk and cached — they don't consume conversation tokens.
-  if (config.workspace) {
-    const wsFiles = loadWorkspaceFiles(config.workspace);
-    if (wsFiles.size > 0) {
-      prompt += "\n# Workspace Context\n";
-      for (const [filename, content] of wsFiles) {
-        prompt += `\n## ${filename}\n${content}\n`;
-      }
-    }
-  }
-
-  // Load team charter if configured (legacy — workspace files supersede this)
-  if (config.team_charter && !config.workspace) {
-    const charter = loadCharter(config.team_charter);
-    if (charter) {
-      prompt += `\n${charter}\n`;
-    }
-  }
-
-  prompt += `
-## Communication
-Messages are prefixed with [sender_handle]: or [sender_handle in group chat]: to tell you who's talking.
-In group chats, multiple people (humans and agents) may be present. Address them by name when relevant.
-Don't repeat or quote these prefixes in your responses — just respond naturally.
-If you decide not to respond to a group message, reply with exactly: __SKIP__
-`;
-
-  if (contextName !== "global") {
-    prompt += `\n## Active Context: ${contextName}\nYou are currently working in the "${contextName}" project context.\n`;
-  }
-
-  // L3 semantic knowledge (higher-level patterns, decisions, architecture)
-  if (l3Knowledge.length > 0) {
-    prompt += "\n## Established Knowledge (learned patterns)\n\n";
-    for (const entry of l3Knowledge) {
-      prompt += `- ${entry.content}\n`;
-    }
-  }
-
-  // L2 episodic memories (recent interactions)
-  if (episodes.length > 0) {
-    prompt += "\n## Relevant memories from previous conversations\n\n";
-    for (const ep of episodes) {
-      const timeAgo = formatTimeAgo(ep.timestamp);
-      const ctxLabel = ep.context_name !== contextName ? ` [from: ${ep.context_name}]` : "";
-      prompt += `[${timeAgo}]${ctxLabel} ${ep.role}: ${ep.content}\n`;
-    }
-    prompt += "\nUse these memories naturally — reference past conversations when relevant, but don't force it.\n";
-  }
-
-  return prompt;
-}
-
-export function buildMessages(
-  systemPrompt: string,
-  conversationHistory: ChatMessage[],
-  currentMessage: string,
-): ChatMessage[] {
-  return [
-    { role: "system", content: systemPrompt },
-    ...conversationHistory,
-    { role: "user", content: currentMessage },
-  ];
-}
-
-function formatTimeAgo(timestamp: string): string {
-  const date = new Date(timestamp);
-  const now = new Date();
-  const diffMs = now.getTime() - date.getTime();
-  const diffMins = Math.floor(diffMs / 60_000);
-  const diffHours = Math.floor(diffMs / 3_600_000);
-  const diffDays = Math.floor(diffMs / 86_400_000);
-
-  if (diffMins < 1) return "just now";
-  if (diffMins < 60) return `${diffMins}m ago`;
-  if (diffHours < 24) return `${diffHours}h ago`;
-  if (diffDays < 7) return `${diffDays}d ago`;
-  return date.toLocaleDateString();
-}