@neuroverseos/governance 0.3.0 → 0.3.1

package/dist/chunk-2NICNKOM.js

@@ -1,100 +0,0 @@
-import {
-  evaluateGuard
-} from "./chunk-4JRYGIO7.js";
-import {
-  loadWorld
-} from "./chunk-JZPQGIKR.js";
-
-// src/adapters/express.ts
-function methodToCategory(method) {
-  switch (method.toUpperCase()) {
-    case "GET":
-    case "HEAD":
-    case "OPTIONS":
-      return "read";
-    case "POST":
-    case "PUT":
-    case "PATCH":
-      return "write";
-    case "DELETE":
-      return "delete";
-    default:
-      return "other";
-  }
-}
-function defaultMapRequest(req) {
-  const method = (req.method ?? "GET").toUpperCase();
-  const path = req.path ?? req.url ?? "/";
-  return {
-    intent: `${method} ${path}`,
-    tool: "http",
-    scope: path,
-    actionCategory: methodToCategory(method),
-    direction: "input",
-    args: {
-      method,
-      path,
-      ...req.params ?? {},
-      ...req.query ?? {}
-    }
-  };
-}
-function defaultOnBlock(verdict, _req, res, statusCode) {
-  const body = {
-    error: "Governance policy violation",
-    reason: verdict.reason ?? "Action not permitted",
-    ruleId: verdict.ruleId,
-    status: verdict.status
-  };
-  if (res.status && res.json) {
-    res.status(statusCode).json(body);
-  } else if (res.send) {
-    res.statusCode = statusCode;
-    res.send(JSON.stringify(body));
-  } else if (res.end) {
-    res.statusCode = statusCode;
-    res.end();
-  }
-}
-async function createGovernanceMiddleware(worldPath, options) {
-  const world = await loadWorld(worldPath);
-  return createGovernanceMiddlewareFromWorld(world, options);
-}
-function createGovernanceMiddlewareFromWorld(world, options = {}) {
-  const engineOptions = {
-    trace: options.trace ?? false,
-    level: options.level
-  };
-  const mapRequest = options.mapRequest ?? defaultMapRequest;
-  const blockStatusCode = options.blockStatusCode ?? 403;
-  return async function neuroVerseGovernance(req, res, next) {
-    try {
-      const event = mapRequest(req);
-      const verdict = evaluateGuard(event, world, engineOptions);
-      options.onEvaluate?.(verdict, event, req);
-      if (verdict.status === "ALLOW") {
-        next();
-        return;
-      }
-      if (verdict.status === "PAUSE") {
-        const approved = await options.onPause?.(verdict, req);
-        if (approved) {
-          next();
-          return;
-        }
-      }
-      if (options.onBlock) {
-        options.onBlock(verdict, req, res);
-      } else {
-        defaultOnBlock(verdict, req, res, blockStatusCode);
-      }
-    } catch (err) {
-      next(err);
-    }
-  };
-}
-
-export {
-  createGovernanceMiddleware,
-  createGovernanceMiddlewareFromWorld
-};

package/dist/chunk-2PQU3VAN.js

@@ -1,131 +0,0 @@
-import {
-  evaluateGuard
-} from "./chunk-4JRYGIO7.js";
-import {
-  advancePlan,
-  evaluatePlan,
-  getPlanProgress
-} from "./chunk-4QXB6PEO.js";
-import {
-  loadWorld
-} from "./chunk-JZPQGIKR.js";
-
-// src/adapters/openclaw.ts
-var GovernanceBlockedError = class extends Error {
-  verdict;
-  action;
-  constructor(verdict, action) {
-    super(`[NeuroVerse] BLOCKED: ${verdict.reason ?? verdict.ruleId ?? "governance rule"}`);
-    this.name = "GovernanceBlockedError";
-    this.verdict = verdict;
-    this.action = action;
-  }
-};
-function defaultMapAction(action, direction) {
-  return {
-    intent: action.type,
-    tool: action.tool ?? action.type,
-    args: action.input,
-    direction,
-    scope: typeof action.input?.path === "string" ? action.input.path : typeof action.input?.url === "string" ? action.input.url : void 0
-  };
-}
-var NeuroVersePlugin = class {
-  name = "neuroverse-governance";
-  world;
-  options;
-  engineOptions;
-  mapAction;
-  activePlan;
-  constructor(world, options = {}) {
-    this.world = world;
-    this.options = options;
-    this.activePlan = options.plan;
-    this.engineOptions = {
-      trace: options.trace ?? false,
-      level: options.level,
-      plan: this.activePlan
-    };
-    this.mapAction = options.mapAction ?? defaultMapAction;
-  }
-  /**
-   * Evaluate an action before execution.
-   *
-   * @throws GovernanceBlockedError if BLOCKED
-   * @returns HookResult with verdict details
-   */
-  beforeAction(action) {
-    const event = this.mapAction(action, "input");
-    this.engineOptions.plan = this.activePlan;
-    const verdict = evaluateGuard(event, this.world, this.engineOptions);
-    const result = {
-      allowed: verdict.status === "ALLOW",
-      verdict,
-      action
-    };
-    this.options.onEvaluate?.(result);
-    if (verdict.status === "BLOCK") {
-      throw new GovernanceBlockedError(verdict, action);
-    }
-    if (verdict.status === "ALLOW" && this.activePlan) {
-      const planVerdict = evaluatePlan(event, this.activePlan);
-      if (planVerdict.matchedStep) {
-        const advResult = advancePlan(this.activePlan, planVerdict.matchedStep);
-        if (advResult.success && advResult.plan) {
-          this.activePlan = advResult.plan;
-          this.engineOptions.plan = this.activePlan;
-        }
-        const progress = getPlanProgress(this.activePlan);
-        this.options.onPlanProgress?.(progress);
-        if (progress.completed === progress.total) {
-          this.options.onPlanComplete?.();
-        }
-      }
-    }
-    return result;
-  }
-  /**
-   * Evaluate an action's output (post-execution governance).
-   * Only runs if evaluateOutputs is enabled.
-   *
-   * @returns HookResult or null if output evaluation is disabled
-   */
-  afterAction(action, _output) {
-    if (!this.options.evaluateOutputs) return null;
-    const event = this.mapAction(action, "output");
-    const verdict = evaluateGuard(event, this.world, this.engineOptions);
-    const result = {
-      allowed: verdict.status === "ALLOW",
-      verdict,
-      action
-    };
-    this.options.onEvaluate?.(result);
-    if (verdict.status === "BLOCK") {
-      throw new GovernanceBlockedError(verdict, action);
-    }
-    return result;
-  }
-  /**
-   * Get the plugin hooks object for agent.use().
-   */
-  hooks() {
-    return {
-      beforeAction: (action) => this.beforeAction(action),
-      afterAction: (action, output) => this.afterAction(action, output)
-    };
-  }
-};
-async function createNeuroVersePlugin(worldPath, options) {
-  const world = await loadWorld(worldPath);
-  return new NeuroVersePlugin(world, options);
-}
-function createNeuroVersePluginFromWorld(world, options) {
-  return new NeuroVersePlugin(world, options);
-}
-
-export {
-  GovernanceBlockedError,
-  NeuroVersePlugin,
-  createNeuroVersePlugin,
-  createNeuroVersePluginFromWorld
-};

package/dist/chunk-4A7LISES.js

@@ -1,324 +0,0 @@
-import {
-  evaluateGuard
-} from "./chunk-4JRYGIO7.js";
-import {
-  advancePlan,
-  evaluatePlan,
-  getPlanProgress
-} from "./chunk-4QXB6PEO.js";
-import {
-  loadWorld
-} from "./chunk-JZPQGIKR.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) {
-        const advResult = advancePlan(this.state.plan, planVerdict.matchedStep);
-        if (advResult.success && advResult.plan) {
-          this.state.plan = advResult.plan;
-          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
-};