@kynver-app/openclaw-agent-os 0.1.19 → 0.1.20

package/package.json

@@ -2,9 +2,12 @@
   "name": "@kynver-app/openclaw-agent-os",
   "private": false,
   "type": "module",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "description": "OpenClaw plugin that exposes Kynver AgentOS as first-class agent tools",
   "main": "./dist/index.js",
+  "bin": {
+    "kynver-openclaw-agent-os-bootstrap": "./scripts/bootstrap-openclaw.mjs"
+  },
   "exports": {
     ".": {
       "import": "./dist/index.js",
@@ -29,6 +32,7 @@
   },
   "files": [
     "dist/**",
+    "scripts/**",
     "openclaw.plugin.json",
     "README.md",
     "SECURITY.md"

package/scripts/bootstrap-openclaw.mjs

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+
+const DEFAULT_PACKAGE = "@kynver-app/openclaw-agent-os@latest";
+const PLUGIN_ID = "kynver-agent-os-tools";
+
+function usage() {
+  console.log(`Usage: kynver-openclaw-agent-os-bootstrap [options]
+
+Installs and configures the Kynver AgentOS OpenClaw plugin.
+
+Options:
+  --api-url <url>        Kynver API origin. Defaults to KYNVER_API_URL or https://www.kynver.com.
+  --api-key <key>        Optional Kynver API key to write into plugin config. Prefer KYNVER_API_KEY in the gateway environment.
+  --harness-repo <path>  Kynver repo path for kynver_harness_* tools. Defaults to KYNVER_HARNESS_REPO.
+  --no-harness           Do not enable kynver_harness_* tools.
+  --package <spec>       Plugin package spec to install. Defaults to ${DEFAULT_PACKAGE}.
+  --skip-install         Only patch config, validate, restart, and inspect.
+  --skip-restart         Do not restart the OpenClaw gateway.
+  --dry-run              Print and validate the config patch without applying it.
+  --help                 Show this help.
+`);
+}
+
+function parseArgs(argv) {
+  const opts = {
+    apiUrl: process.env.KYNVER_API_URL || "https://www.kynver.com",
+    apiKey: "",
+    harnessRepo: process.env.KYNVER_HARNESS_REPO || "",
+    enableHarness: true,
+    packageSpec: DEFAULT_PACKAGE,
+    skipInstall: false,
+    skipRestart: false,
+    dryRun: false,
+  };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    const next = () => {
+      const value = argv[i + 1];
+      if (!value || value.startsWith("--")) throw new Error(`${arg} requires a value`);
+      i += 1;
+      return value;
+    };
+
+    if (arg === "--api-url") opts.apiUrl = next();
+    else if (arg === "--api-key") opts.apiKey = next();
+    else if (arg === "--harness-repo") opts.harnessRepo = next();
+    else if (arg === "--no-harness") opts.enableHarness = false;
+    else if (arg === "--package") opts.packageSpec = next();
+    else if (arg === "--skip-install") opts.skipInstall = true;
+    else if (arg === "--skip-restart") opts.skipRestart = true;
+    else if (arg === "--dry-run") opts.dryRun = true;
+    else if (arg === "--help" || arg === "-h") {
+      usage();
+      process.exit(0);
+    } else {
+      throw new Error(`Unknown option: ${arg}`);
+    }
+  }
+
+  opts.apiUrl = opts.apiUrl.replace(/\/$/, "");
+  return opts;
+}
+
+function run(command, args, { input, allowFailure = false } = {}) {
+  const shown = [command, ...args].join(" ");
+  console.error(`$ ${shown}`);
+  const result = spawnSync(command, args, {
+    input,
+    encoding: "utf8",
+    stdio: input === undefined ? "inherit" : ["pipe", "inherit", "inherit"],
+  });
+
+  if (result.error) throw result.error;
+  if (result.status !== 0 && !allowFailure) {
+    throw new Error(`${shown} failed with exit ${result.status}`);
+  }
+  return result;
+}
+
+function buildPatch(opts) {
+  const config = {
+    kynverApiUrl: opts.apiUrl,
+    enableDirectHttp: true,
+    enableSessionLifecycle: true,
+    enableRuntimeSkillManifest: true,
+    enableContinuityGuidance: true,
+    enableHarnessTools: Boolean(opts.enableHarness && opts.harnessRepo),
+  };
+
+  if (opts.apiKey) config.kynverApiKey = opts.apiKey;
+  if (opts.enableHarness && opts.harnessRepo) config.harnessRepo = opts.harnessRepo;
+
+  return {
+    plugins: {
+      entries: {
+        [PLUGIN_ID]: {
+          enabled: true,
+          config,
+        },
+      },
+    },
+  };
+}
+
+try {
+  const opts = parseArgs(process.argv.slice(2));
+
+  if (opts.enableHarness && !opts.harnessRepo) {
+    console.error("Harness tools will stay disabled because --harness-repo/KYNVER_HARNESS_REPO is not set.");
+  }
+  if (process.env.KYNVER_API_KEY && !opts.apiKey) {
+    console.error("KYNVER_API_KEY is set for this process. It will not be written to config; make sure the OpenClaw gateway service also has it.");
+  } else if (!opts.apiKey) {
+    console.error("KYNVER_API_KEY is not set. Direct HTTP tools need it in the OpenClaw gateway environment or pass --api-key to write it into plugin config.");
+  }
+
+  if (!opts.skipInstall && !opts.dryRun) {
+    run("openclaw", ["plugins", "install", opts.packageSpec, "--force"]);
+  }
+
+  const patch = JSON.stringify(buildPatch(opts), null, 2);
+  if (opts.dryRun) {
+    console.log(patch);
+    run("openclaw", ["config", "patch", "--stdin", "--dry-run"], { input: patch });
+  } else {
+    run("openclaw", ["config", "patch", "--stdin"], { input: patch });
+    run("openclaw", ["config", "validate"]);
+    if (!opts.skipRestart) run("openclaw", ["gateway", "restart"]);
+    run("openclaw", ["plugins", "inspect", PLUGIN_ID, "--runtime", "--json"], { allowFailure: true });
+  }
+} catch (error) {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+}