@neuroverseos/governance 0.1.6 → 0.2.1

package/dist/chunk-5EDDNJU6.js

@@ -0,0 +1,321 @@
+import {
+  evaluateGuard
+} from "./chunk-PQBJBVSW.js";
+import {
+  loadWorld
+} from "./chunk-JZPQGIKR.js";
+import {
+  advancePlan,
+  evaluatePlan,
+  getPlanProgress
+} from "./chunk-P74Y66ZV.js";
+
+// src/runtime/session.ts
+async function defaultToolExecutor(name, args) {
+  return `Tool "${name}" executed successfully with args: ${JSON.stringify(args)}`;
+}
+var SessionManager = class {
+  config;
+  state;
+  engineOptions;
+  executor;
+  constructor(config) {
+    this.config = config;
+    this.executor = config.toolExecutor ?? defaultToolExecutor;
+    this.engineOptions = {
+      trace: config.trace ?? false,
+      level: config.level,
+      plan: config.plan
+    };
+    this.state = {
+      active: false,
+      world: config.world,
+      plan: config.plan,
+      progress: config.plan ? getPlanProgress(config.plan) : void 0,
+      actionsEvaluated: 0,
+      actionsAllowed: 0,
+      actionsBlocked: 0,
+      actionsPaused: 0
+    };
+  }
+  /**
+   * Initialize the session — load world from disk if needed.
+   */
+  async start() {
+    if (this.config.worldPath && !this.config.world) {
+      this.state.world = await loadWorld(this.config.worldPath);
+    }
+    if (!this.state.world) {
+      throw new Error("No world provided. Use --world or pass a world definition.");
+    }
+    this.state.active = true;
+    return this.getState();
+  }
+  /**
+   * Evaluate a single event against governance.
+   * Returns the verdict without executing anything.
+   */
+  evaluate(event) {
+    this.engineOptions.plan = this.state.plan;
+    const verdict = evaluateGuard(event, this.state.world, this.engineOptions);
+    this.state.actionsEvaluated++;
+    if (verdict.status === "ALLOW") this.state.actionsAllowed++;
+    if (verdict.status === "BLOCK") this.state.actionsBlocked++;
+    if (verdict.status === "PAUSE") this.state.actionsPaused++;
+    this.config.onVerdict?.(verdict, event);
+    return verdict;
+  }
+  /**
+   * Evaluate and execute a tool call.
+   * Returns the execution result or block reason.
+   */
+  async executeToolCall(toolCall) {
+    let args;
+    try {
+      args = JSON.parse(toolCall.function.arguments);
+    } catch {
+      args = { raw: toolCall.function.arguments };
+    }
+    const event = {
+      intent: toolCall.function.name,
+      tool: toolCall.function.name,
+      args,
+      direction: "input"
+    };
+    const verdict = this.evaluate(event);
+    if (verdict.status === "BLOCK") {
+      return { allowed: false, verdict };
+    }
+    if (verdict.status === "PAUSE") {
+      return { allowed: false, verdict };
+    }
+    const result = await this.executor(toolCall.function.name, args);
+    this.config.onToolResult?.(toolCall.function.name, result);
+    if (this.state.plan) {
+      const planVerdict = evaluatePlan(event, this.state.plan);
+      if (planVerdict.matchedStep) {
+        this.state.plan = advancePlan(this.state.plan, planVerdict.matchedStep);
+        this.engineOptions.plan = this.state.plan;
+        this.state.progress = getPlanProgress(this.state.plan);
+        this.config.onPlanProgress?.(this.state.progress);
+        if (this.state.progress.completed === this.state.progress.total) {
+          this.config.onPlanComplete?.();
+        }
+      }
+    }
+    return { allowed: true, verdict, result };
+  }
+  /**
+   * Process a model response — evaluate and execute all tool calls.
+   * Returns results for each tool call.
+   */
+  async processModelResponse(response, model) {
+    if (response.toolCalls.length === 0) {
+      return response;
+    }
+    for (const toolCall of response.toolCalls) {
+      const { allowed, verdict, result } = await this.executeToolCall(toolCall);
+      if (allowed && result) {
+        const nextResponse = await model.sendToolResult(toolCall.id, result);
+        if (nextResponse.toolCalls.length > 0) {
+          return this.processModelResponse(nextResponse, model);
+        }
+        return nextResponse;
+      } else {
+        const reason = verdict.reason ?? "Action blocked by governance.";
+        const nextResponse = await model.sendBlockedResult(toolCall.id, reason);
+        if (nextResponse.toolCalls.length > 0) {
+          return this.processModelResponse(nextResponse, model);
+        }
+        return nextResponse;
+      }
+    }
+    return response;
+  }
+  /** Get current session state. */
+  getState() {
+    return { ...this.state };
+  }
+  /** Stop the session. */
+  stop() {
+    this.state.active = false;
+    return this.getState();
+  }
+};
+async function runPipeMode(config) {
+  const session = new SessionManager(config);
+  await session.start();
+  const state = session.getState();
+  process.stderr.write(`[neuroverse] Pipe mode active
+`);
+  process.stderr.write(`[neuroverse] World: ${state.world.world.name}
+`);
+  if (state.plan) {
+    process.stderr.write(`[neuroverse] Plan: ${state.plan.plan_id} (${state.plan.objective})
+`);
+  }
+  return new Promise((resolve, reject) => {
+    let buffer = "";
+    process.stdin.setEncoding("utf-8");
+    process.stdin.on("data", (chunk) => {
+      buffer += chunk;
+      const lines = buffer.split("\n");
+      buffer = lines.pop() ?? "";
+      for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed) continue;
+        try {
+          const event = JSON.parse(trimmed);
+          if (!event.intent) {
+            process.stderr.write(`[neuroverse] Warning: event missing "intent" field
+`);
+            continue;
+          }
+          const verdict = session.evaluate(event);
+          process.stdout.write(JSON.stringify(verdict) + "\n");
+        } catch (err) {
+          process.stderr.write(`[neuroverse] Error parsing line: ${err}
+`);
+        }
+      }
+    });
+    process.stdin.on("end", () => {
+      if (buffer.trim()) {
+        try {
+          const event = JSON.parse(buffer.trim());
+          if (event.intent) {
+            const verdict = session.evaluate(event);
+            process.stdout.write(JSON.stringify(verdict) + "\n");
+          }
+        } catch {
+        }
+      }
+      const finalState = session.stop();
+      process.stderr.write(
+        `[neuroverse] Session complete: ${finalState.actionsEvaluated} evaluated, ${finalState.actionsAllowed} allowed, ${finalState.actionsBlocked} blocked, ${finalState.actionsPaused} paused
+`
+      );
+      resolve();
+    });
+    process.stdin.on("error", reject);
+  });
+}
+async function runInteractiveMode(config, model) {
+  const session = new SessionManager(config);
+  await session.start();
+  const state = session.getState();
+  process.stdout.write("\n");
+  process.stdout.write(`  World: ${state.world.world.name}
+`);
+  if (state.plan) {
+    process.stdout.write(`  Plan: ${state.plan.plan_id}
+`);
+    process.stdout.write(`  Goal: ${state.plan.objective}
+`);
+    process.stdout.write(`  Steps: ${state.progress?.total ?? 0}
+`);
+  }
+  process.stdout.write(`  Type "exit" to end session.
+`);
+  process.stdout.write("\n");
+  const readline = await import("readline");
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    prompt: "> "
+  });
+  const printProgress = () => {
+    const s = session.getState();
+    if (s.progress) {
+      process.stdout.write(
+        `  [plan: ${s.progress.completed}/${s.progress.total} (${s.progress.percentage}%)]
+`
+      );
+    }
+  };
+  rl.prompt();
+  rl.on("line", async (input) => {
+    const trimmed = input.trim();
+    if (!trimmed) {
+      rl.prompt();
+      return;
+    }
+    if (trimmed === "exit" || trimmed === "quit") {
+      const finalState = session.stop();
+      process.stdout.write("\n");
+      process.stdout.write(`  Session complete.
+`);
+      process.stdout.write(`  Actions: ${finalState.actionsEvaluated} evaluated`);
+      process.stdout.write(`, ${finalState.actionsAllowed} allowed`);
+      process.stdout.write(`, ${finalState.actionsBlocked} blocked
+`);
+      if (finalState.progress) {
+        process.stdout.write(
+          `  Plan: ${finalState.progress.completed}/${finalState.progress.total} steps completed
+`
+        );
+      }
+      process.stdout.write("\n");
+      rl.close();
+      return;
+    }
+    if (trimmed === "status") {
+      const s = session.getState();
+      process.stdout.write(`
+  World: ${s.world.world.name}
+`);
+      process.stdout.write(`  Actions: ${s.actionsEvaluated} evaluated
+`);
+      process.stdout.write(`  Allowed: ${s.actionsAllowed} | Blocked: ${s.actionsBlocked} | Paused: ${s.actionsPaused}
+`);
+      if (s.progress && s.plan) {
+        process.stdout.write(`  Plan: ${s.plan.plan_id} \u2014 ${s.progress.completed}/${s.progress.total} (${s.progress.percentage}%)
+`);
+        for (const step of s.plan.steps) {
+          const icon = step.status === "completed" ? "[x]" : "[ ]";
+          process.stdout.write(`    ${icon} ${step.label}
+`);
+        }
+      }
+      process.stdout.write("\n");
+      rl.prompt();
+      return;
+    }
+    try {
+      const response = await model.chat(trimmed);
+      if (response.toolCalls.length > 0) {
+        const finalResponse = await session.processModelResponse(response, model);
+        if (finalResponse.content) {
+          process.stdout.write(`
+${finalResponse.content}
+
+`);
+        }
+        printProgress();
+      } else if (response.content) {
+        process.stdout.write(`
+${response.content}
+
+`);
+      }
+    } catch (err) {
+      process.stderr.write(`
+  Error: ${err}
+
+`);
+    }
+    rl.prompt();
+  });
+  rl.on("close", () => {
+    session.stop();
+  });
+  return new Promise((resolve) => {
+    rl.on("close", resolve);
+  });
+}
+
+export {
+  SessionManager,
+  runPipeMode,
+  runInteractiveMode
+};