@inceptionstack/roundhouse 0.5.12 → 0.5.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inceptionstack/roundhouse",
-  "version": "0.5.12",
+  "version": "0.5.13",
   "type": "module",
   "description": "Multi-platform chat gateway that routes messages through a configured AI agent",
   "license": "MIT",

package/src/gateway/gateway.ts

@@ -30,6 +30,7 @@ import type { TransportAdapter } from "../transports";
 import { hostname } from "node:os";
 import { join } from "node:path";
 import { injectToolsSection } from "./tools-inject";
+import { injectPersonaSection, loadPersona } from "./persona-inject";
 
 /** Bot username for command suffix validation (set during gateway init) */
 let _botUsername = "";
@@ -327,6 +328,9 @@ export class Gateway {
       await handleOrAbort(thread, message);
     });
 
+    // ── Load persona files at startup (cached for process lifetime) ───
+    loadPersona();
+
     // ── Handle inline keyboard callbacks ───
     this.chat.onAction(MODEL_ACTION_ID, async (event: any) => {
       await handleModelAction({ value: event.value, thread: event.thread });
@@ -408,6 +412,7 @@ export class Gateway {
 
       // Inject tools section (after STT enrichment so voice-only messages get it too)
       if (agentMessage.text) {
+        agentMessage.text = injectPersonaSection(agentMessage.text);
         agentMessage.text = injectToolsSection(agentMessage.text);
       }
 

package/src/gateway/later-command.ts

@@ -33,7 +33,7 @@ function ensureLaterFile(): void {
 
 export async function handleLater(ctx: LaterCommandContext): Promise<void> {
   const { thread, text, postWithFallback } = ctx;
-  const idea = text.replace(/^\/later\s*/i, "").trim();
+  const idea = text.replace(/^\/later(@\S+)?\s*/i, "").trim();
 
   // No argument: show contents
   if (!idea) {

package/src/gateway/model-command.ts

@@ -10,7 +10,7 @@
 
 import { homedir } from "node:os";
 import { join } from "node:path";
-import { readFileSync, writeFileSync } from "node:fs";
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
 
 /** Known model aliases → Bedrock model IDs */
 export const MODEL_ALIASES: Record<string, { provider: string; model: string; label: string }> = {
@@ -58,6 +58,7 @@ function readSettings(): Record<string, any> {
 }
 
 function writeSettings(settings: Record<string, any>): void {
+  mkdirSync(join(homedir(), ".pi", "agent"), { recursive: true });
   writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2) + "\n");
 }
 

package/src/gateway/persona-inject.ts

@@ -0,0 +1,94 @@
+/**
+ * gateway/persona-inject.ts — Inject <persona> section into agent prompts
+ *
+ * Reads user.md and soul.md (user-customized or bundled defaults) and
+ * prepends them as a structured section so the agent has identity and
+ * user context on every turn.
+ *
+ * Cached with mtime-based invalidation: stat() on each turn (~0.1ms),
+ * only re-reads if files have been modified since last load.
+ */
+
+import { readFileSync, statSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { ROUNDHOUSE_DIR } from "../config";
+
+let cachedPersona: string | null = null;
+let lastMtime = 0;
+
+const SOUL_PATH = join(ROUNDHOUSE_DIR, "soul.md");
+const USER_PATH = join(ROUNDHOUSE_DIR, "user.md");
+
+function getMaxMtime(): number {
+  let max = 0;
+  try { max = Math.max(max, statSync(SOUL_PATH).mtimeMs); } catch {}
+  try { max = Math.max(max, statSync(USER_PATH).mtimeMs); } catch {}
+  return max;
+}
+
+function loadFile(filename: string): string {
+  const userPath = join(ROUNDHOUSE_DIR, filename);
+  const bundledPath = join(dirname(fileURLToPath(import.meta.url)), filename);
+
+  try {
+    return readFileSync(userPath, "utf8");
+  } catch {
+    try {
+      return readFileSync(bundledPath, "utf8");
+    } catch {
+      return "";
+    }
+  }
+}
+
+function buildPersona(): string {
+  const soul = loadFile("soul.md").trim();
+  const user = loadFile("user.md").trim();
+
+  if (!soul && !user) return "";
+
+  const parts: string[] = [];
+  if (soul) parts.push(soul);
+  if (user) parts.push(user);
+  return parts.join("\n\n---\n\n");
+}
+
+/**
+ * Load persona files and cache the result.
+ * Call at gateway startup to eagerly load.
+ */
+export function loadPersona(): void {
+  cachedPersona = buildPersona();
+  lastMtime = getMaxMtime();
+}
+
+/**
+ * Reload persona from disk. Call after agent edits user.md/soul.md
+ * (e.g. from an IPC handler or post-tool-execution hook).
+ */
+export function reloadPersona(): void {
+  cachedPersona = buildPersona();
+  lastMtime = getMaxMtime();
+}
+
+/**
+ * Prepend a <persona> section to the prompt text.
+ * Only injects if soul.md or user.md have content.
+ * Auto-reloads if files have been modified since last load.
+ */
+export function injectPersonaSection(text: string): string {
+  if (cachedPersona === null) {
+    loadPersona();
+  } else {
+    // Cheap mtime check — auto-reload if agent edited the files
+    const currentMtime = getMaxMtime();
+    if (currentMtime !== lastMtime) {
+      reloadPersona();
+    }
+  }
+  if (!cachedPersona) return text;
+  // Escape any literal </persona> in content to prevent XML injection
+  const safe = cachedPersona.replace(/<\/persona>/gi, "&lt;/persona&gt;");
+  return `<persona>\n${safe}\n</persona>\n\n${text}`;
+}

package/src/gateway/soul.md

@@ -0,0 +1,35 @@
+# Who You Are
+
+_You're not a chatbot. You're a technical partner._
+
+## Core Identity
+
+**Name:** Loki
+**Role:** Senior engineer and ops partner. You help build, deploy, debug, and maintain software and infrastructure. You have opinions and you share them.
+
+## Core Truths
+
+**Be genuinely helpful, not performatively helpful.** Skip the filler — just help. Actions speak louder than words.
+
+**Have opinions.** When something is a bad pattern, say so. When there's a better approach, recommend it. You're not a yes-machine.
+
+**Be resourceful before asking.** Check the docs. Read the file. Try things. _Then_ ask if you're stuck.
+
+**Earn trust through competence.** You have access to tools, shell, and infrastructure. Use them wisely. Be careful with destructive operations. Be bold with read operations.
+
+**Think holistically.** Consider the broader context — architecture, maintainability, security, user experience.
+
+## Boundaries
+
+- Ask before destructive operations (deletions, config changes with blast radius)
+- Read freely — list, describe, get operations are safe
+- Private things stay private
+- Never send half-baked replies
+
+## Vibe
+
+Direct, technical, concise. Think senior engineer talking to senior engineer. Thorough when it matters, brief when it doesn't. No corporate speak.
+
+## Continuity
+
+Each session, you wake up fresh. Your workspace files _are_ your memory. Read them. Update them.

package/src/gateway/tools.md

@@ -10,6 +10,8 @@ Do NOT create files directly in `~/` or pollute the home directory. Use subdirec
 - `~/.roundhouse/workspace/later.md` — ideas saved via `/later`
 - `~/.roundhouse/workspace/<project>/` — project-specific files if needed
 
+> 💡 When looking for things to work on, check `~/.roundhouse/workspace/later.md` for saved ideas and tasks.
+
 ## roundhouse cron add
 
 Schedule recurring or one-shot jobs. The user may ask you to "remind me", "check every X", "do Y later", or "schedule Z".

package/src/gateway/user.md

@@ -0,0 +1,10 @@
+# About Your Human
+
+- **Name:** (not yet set)
+- **What to call them:** (use their Telegram username until they tell you otherwise)
+- **Timezone:** UTC
+- **Notes:** (learn about them through conversation)
+
+## Preferences
+
+- (Will be filled in as you learn what they prefer)

package/src/provisioning/bundle.ts

@@ -320,6 +320,8 @@ export function provisionWorkspaceFiles(opts: ProvisionOpts = {}): void {
   // Files to provision: [bundled filename, target filename]
   const files: [string, string][] = [
     ["tools.md", "tools.md"],
+    ["soul.md", "soul.md"],
+    ["user.md", "user.md"],
   ];
 
   try {