@geravant/sinain 1.0.18 → 1.0.19

package/install.js

@@ -120,7 +120,8 @@ async function installNemoClaw({ sandboxName }) {
   cfg.agents.defaults                                ??= {};
   cfg.agents.defaults.sandbox                        ??= {};
   cfg.agents.defaults.sandbox.sessionToolsVisibility  = "all";
-  // NemoClaw: gateway bind/auth and compaction are managed by OpenShell — do not overwrite them
+  // NemoClaw: gateway bind/auth are managed by OpenShell — but compaction must be set explicitly
+  cfg.compaction = { mode: "safeguard", maxHistoryShare: 0.2, reserveTokensFloor: 40000 };
 
   const token = cfg.gateway?.auth?.token ?? "(see sandbox openclaw.json)";
 

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@geravant/sinain",
-  "version": "1.0.18",
+  "version": "1.0.19",
   "description": "sinain OpenClaw plugin — AI overlay for macOS",
   "type": "module",
   "bin": {
-    "sinain": "./install.js"
+    "sinain": "./install.js",
+    "sinain-knowledge": "./sinain-knowledge/deploy/cli.ts"
   },
   "scripts": {
     "postinstall": "node install.js"
@@ -14,6 +15,7 @@
     "openclaw.plugin.json",
     "install.js",
     "sinain-memory",
+    "sinain-knowledge",
     "HEARTBEAT.md",
     "SKILL.md"
   ],

package/sinain-knowledge/adapters/generic/adapter.ts

@@ -0,0 +1,103 @@
+/**
+ * sinain-knowledge — Generic BackendAdapter
+ *
+ * Runs the knowledge system without OpenClaw — uses child_process for script
+ * execution, a configurable workspace path, and console logging for alerts.
+ */
+
+import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+
+import type { ScriptResult } from "../../data/schema.js";
+import type { BackendAdapter, BackendCapabilities, ScriptOptions } from "../interface.js";
+
+// ============================================================================
+// GenericAdapter
+// ============================================================================
+
+export class GenericAdapter implements BackendAdapter {
+  readonly name = "generic";
+  readonly capabilities: BackendCapabilities = {
+    hasHeartbeatTool: false,
+    hasRPC: false,
+    hasSessionHistory: false,
+    hasTranscriptAccess: false,
+    supportsPython: true,
+    hasTelegramAlerts: false,
+  };
+
+  constructor(private workspaceDir: string) {}
+
+  getWorkspaceDir(): string | null {
+    return this.workspaceDir;
+  }
+
+  async runScript(args: string[], opts: ScriptOptions): Promise<ScriptResult> {
+    // Try uv first, fall back to python3
+    const [cmd, ...rest] = this._resolveCommand(args);
+
+    return new Promise((resolve, reject) => {
+      const child = execFile(cmd, rest, {
+        cwd: opts.cwd,
+        timeout: opts.timeoutMs,
+        maxBuffer: 10 * 1024 * 1024,
+      }, (error, stdout, stderr) => {
+        if (error && (error as any).killed) {
+          reject(new Error(`Command timed out after ${opts.timeoutMs}ms`));
+          return;
+        }
+        resolve({
+          code: error ? (error as any).code ?? 1 : 0,
+          stdout: stdout ?? "",
+          stderr: stderr ?? "",
+        });
+      });
+    });
+  }
+
+  resolvePath(configPath: string): string {
+    return resolve(configPath);
+  }
+
+  // No session management in generic mode
+
+  // Alerts go to console
+  async sendAlert(type: string, title: string, body: string): Promise<void> {
+    console.log(`[sinain-alert:${type}] ${title}\n${body}`);
+  }
+
+  async initialize(): Promise<void> {
+    // Detect python availability
+    try {
+      await this.runScript(["python3", "--version"], { timeoutMs: 5000, cwd: this.workspaceDir });
+    } catch {
+      console.warn("sinain-knowledge: python3 not found — some features will be unavailable");
+    }
+  }
+
+  dispose(): void {
+    // Nothing to clean up
+  }
+
+  // ── Internal ──────────────────────────────────────────────────────────
+
+  private _resolveCommand(args: string[]): string[] {
+    // If args starts with "uv", try to use it, otherwise strip the uv prefix
+    if (args[0] === "uv") {
+      try {
+        // Check if uv is available
+        require("node:child_process").execFileSync("uv", ["--version"], { timeout: 3000 });
+        return args;
+      } catch {
+        // Strip "uv run --with <pkg>" prefix → just run python3 directly
+        const pythonIdx = args.indexOf("python3");
+        if (pythonIdx >= 0) {
+          return args.slice(pythonIdx);
+        }
+        return args;
+      }
+    }
+    return args;
+  }
+}

package/sinain-knowledge/adapters/interface.ts

@@ -0,0 +1,72 @@
+/**
+ * sinain-knowledge — BackendAdapter interface
+ *
+ * Abstracts the runtime environment (OpenClaw, generic CLI, etc.) so the
+ * knowledge system (KnowledgeStore + CurationEngine) can run on any backend.
+ */
+
+import type { ScriptResult } from "../data/schema.js";
+
+// ============================================================================
+// Capabilities
+// ============================================================================
+
+export interface BackendCapabilities {
+  hasHeartbeatTool: boolean;
+  hasRPC: boolean;
+  hasSessionHistory: boolean;
+  hasTranscriptAccess: boolean;
+  supportsPython: boolean;
+  hasTelegramAlerts: boolean;
+}
+
+// ============================================================================
+// Script execution options
+// ============================================================================
+
+export interface ScriptOptions {
+  timeoutMs: number;
+  cwd: string;
+}
+
+// ============================================================================
+// BackendAdapter
+// ============================================================================
+
+export interface BackendAdapter {
+  readonly name: string;
+  readonly capabilities: BackendCapabilities;
+
+  /** Get the current workspace directory, if available. */
+  getWorkspaceDir(): string | null;
+
+  /** Execute a command and return its result. */
+  runScript(args: string[], opts: ScriptOptions): Promise<ScriptResult>;
+
+  /** Resolve a config-relative path to an absolute path. */
+  resolvePath(configPath: string): string;
+
+  // ── Session management (optional) ─────────────────────────────────────
+
+  /** Path to sessions.json, if accessible. */
+  getSessionsJsonPath?(): string | null;
+
+  /** Get transcript file size for overflow detection. */
+  getTranscriptSize?(): { path: string; bytes: number } | null;
+
+  /** Truncate and archive the current session transcript. */
+  performTranscriptReset?(): boolean;
+
+  // ── Alerts (optional) ─────────────────────────────────────────────────
+
+  /** Send an alert notification (Telegram, webhook, etc.). */
+  sendAlert?(type: string, title: string, body: string): Promise<void>;
+
+  // ── Lifecycle ─────────────────────────────────────────────────────────
+
+  /** Initialize the adapter (called once at plugin startup). */
+  initialize(): Promise<void>;
+
+  /** Dispose resources (called at plugin shutdown). */
+  dispose(): void;
+}

package/sinain-knowledge/adapters/openclaw/adapter.ts

@@ -0,0 +1,223 @@
+/**
+ * sinain-knowledge — OpenClaw BackendAdapter
+ *
+ * Wraps the OpenClaw plugin API to implement the BackendAdapter interface.
+ * Handles script execution (via uv), session file access, transcript management,
+ * and Telegram alerts using the bot token from openclaw.json.
+ */
+
+import { readFileSync, writeFileSync, existsSync, statSync, copyFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+
+import type { ScriptResult } from "../../data/schema.js";
+import type { BackendAdapter, BackendCapabilities, ScriptOptions } from "../interface.js";
+
+// ============================================================================
+// Telegram alert helpers (self-contained within the adapter)
+// ============================================================================
+
+const ALERT_COOLDOWN_MS = 15 * 60_000;
+const OVERFLOW_TRANSCRIPT_MIN_BYTES = 1_000_000;
+
+let _cachedBotToken: string | null | undefined;
+let _alertMissingConfigLogged = false;
+const _alertCooldowns = new Map<string, number>();
+
+function readBotToken(stateDir: string): string | null {
+  if (_cachedBotToken !== undefined) return _cachedBotToken;
+  try {
+    const openclawJson = join(stateDir, "openclaw.json");
+    const raw = JSON.parse(readFileSync(openclawJson, "utf-8"));
+    const token = raw?.channels?.telegram?.botToken ?? raw?.telegram?.botToken ?? null;
+    _cachedBotToken = typeof token === "string" && token.length > 10 ? token : null;
+  } catch {
+    _cachedBotToken = null;
+  }
+  return _cachedBotToken;
+}
+
+// ============================================================================
+// OpenClawAdapter
+// ============================================================================
+
+/**
+ * Minimal type for the OpenClaw plugin API.
+ * Only the methods we actually use — avoids importing the full SDK type.
+ */
+export interface OpenClawApi {
+  pluginConfig: unknown;
+  config: unknown;
+  logger: { info(msg: string): void; warn(msg: string): void };
+  resolvePath(configPath: string): string;
+  runtime: {
+    system: {
+      runCommandWithTimeout(
+        args: string[],
+        opts: { timeoutMs: number; cwd: string },
+      ): Promise<ScriptResult>;
+    };
+  };
+}
+
+export class OpenClawAdapter implements BackendAdapter {
+  readonly name = "openclaw";
+  readonly capabilities: BackendCapabilities = {
+    hasHeartbeatTool: true,
+    hasRPC: true,
+    hasSessionHistory: true,
+    hasTranscriptAccess: true,
+    supportsPython: true,
+    hasTelegramAlerts: true,
+  };
+
+  private workspaceDir: string | null = null;
+
+  constructor(
+    private api: OpenClawApi,
+    private sessionKey: string | undefined,
+  ) {}
+
+  getWorkspaceDir(): string | null {
+    return this.workspaceDir;
+  }
+
+  setWorkspaceDir(dir: string): void {
+    this.workspaceDir = dir;
+  }
+
+  async runScript(args: string[], opts: ScriptOptions): Promise<ScriptResult> {
+    return this.api.runtime.system.runCommandWithTimeout(args, opts);
+  }
+
+  resolvePath(configPath: string): string {
+    return this.api.resolvePath(configPath);
+  }
+
+  // ── Session management ────────────────────────────────────────────────
+
+  getSessionsJsonPath(): string | null {
+    if (!this.workspaceDir) return null;
+    const sessionsDir = join(dirname(this.workspaceDir), "agents", "main", "sessions");
+    const p = join(sessionsDir, "sessions.json");
+    return existsSync(p) ? p : null;
+  }
+
+  getTranscriptSize(): { path: string; bytes: number } | null {
+    const sessionsJsonPath = this.getSessionsJsonPath();
+    if (!sessionsJsonPath || !this.sessionKey) return null;
+    try {
+      const sessionsData = JSON.parse(readFileSync(sessionsJsonPath, "utf-8"));
+      const session = sessionsData[this.sessionKey];
+      const transcriptPath = session?.sessionFile as string | undefined;
+      if (!transcriptPath || !existsSync(transcriptPath)) return null;
+      return { path: transcriptPath, bytes: statSync(transcriptPath).size };
+    } catch {
+      return null;
+    }
+  }
+
+  performTranscriptReset(): boolean {
+    if (!this.sessionKey || !this.workspaceDir) {
+      this.api.logger.warn("sinain-hud: overflow reset aborted — no sessionKey or workspace dir");
+      return false;
+    }
+    const sessionsJsonPath = this.getSessionsJsonPath();
+    if (!sessionsJsonPath) {
+      this.api.logger.warn("sinain-hud: overflow reset aborted — sessions.json not found");
+      return false;
+    }
+    let sessionsData: Record<string, Record<string, unknown>>;
+    try {
+      sessionsData = JSON.parse(readFileSync(sessionsJsonPath, "utf-8"));
+    } catch (err) {
+      this.api.logger.warn(`sinain-hud: overflow reset aborted — cannot parse sessions.json: ${err}`);
+      return false;
+    }
+    const session = sessionsData[this.sessionKey];
+    const transcriptPath = session?.sessionFile as string | undefined;
+    if (!transcriptPath || !existsSync(transcriptPath)) {
+      this.api.logger.warn(`sinain-hud: overflow reset aborted — transcript not found: ${transcriptPath}`);
+      return false;
+    }
+    const size = statSync(transcriptPath).size;
+    if (size < OVERFLOW_TRANSCRIPT_MIN_BYTES) {
+      this.api.logger.info(
+        `sinain-hud: overflow reset skipped — transcript only ${Math.round(size / 1024)}KB (threshold: ${Math.round(OVERFLOW_TRANSCRIPT_MIN_BYTES / 1024)}KB)`,
+      );
+      return false;
+    }
+    const archivePath = transcriptPath.replace(/\.jsonl$/, `.archived.${Date.now()}.jsonl`);
+    try {
+      copyFileSync(transcriptPath, archivePath);
+    } catch (err) {
+      this.api.logger.warn(`sinain-hud: overflow reset aborted — archive failed: ${err}`);
+      return false;
+    }
+    writeFileSync(transcriptPath, "", "utf-8");
+    try {
+      session.contextTokens = 0;
+      writeFileSync(sessionsJsonPath, JSON.stringify(sessionsData, null, 2), "utf-8");
+    } catch {}
+    this.api.logger.info(
+      `sinain-hud: === OVERFLOW RESET === Transcript truncated (was ${Math.round(size / 1024)}KB). Archive: ${archivePath}`,
+    );
+    return true;
+  }
+
+  // ── Alerts ────────────────────────────────────────────────────────────
+
+  async sendAlert(alertType: string, title: string, body: string): Promise<void> {
+    const stateDir = this.getStateDir();
+    if (!stateDir) return;
+
+    const chatId = process.env.SINAIN_ALERT_CHAT_ID;
+    const token = readBotToken(stateDir);
+
+    if (!chatId || !token) {
+      if (!_alertMissingConfigLogged) {
+        _alertMissingConfigLogged = true;
+        console.log("sinain-hud: Telegram alerts disabled (missing SINAIN_ALERT_CHAT_ID or bot token)");
+      }
+      return;
+    }
+
+    const lastSent = _alertCooldowns.get(alertType) ?? 0;
+    if (Date.now() - lastSent < ALERT_COOLDOWN_MS) return;
+    _alertCooldowns.set(alertType, Date.now());
+
+    const text = `${title}\n${body}`;
+    fetch(`https://api.telegram.org/bot${token}/sendMessage`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ chat_id: chatId, text, parse_mode: "Markdown" }),
+    }).catch(() => {});
+  }
+
+  // ── Lifecycle ─────────────────────────────────────────────────────────
+
+  async initialize(): Promise<void> {
+    // Pre-initialize workspace from config
+    const cfgWorkspace = (this.api.config as any).agents?.defaults?.workspace as string | undefined;
+    if (cfgWorkspace && existsSync(cfgWorkspace)) {
+      this.workspaceDir = cfgWorkspace;
+      this.api.logger.info(`sinain-hud: workspace pre-initialized from config: ${this.workspaceDir}`);
+    }
+  }
+
+  dispose(): void {
+    // Nothing to clean up
+  }
+
+  resetAlertState(): void {
+    _alertCooldowns.clear();
+    _cachedBotToken = undefined;
+    _alertMissingConfigLogged = false;
+  }
+
+  // ── Internal helpers ──────────────────────────────────────────────────
+
+  private getStateDir(): string | null {
+    if (!this.workspaceDir) return null;
+    return dirname(this.workspaceDir);
+  }
+}