opensyn 0.1.0

package/openclaw.plugin.json

@@ -0,0 +1,173 @@
+{
+  "id": "opensyn",
+  "name": "OpenSyn",
+  "description": "Expose local OpenSyn context to OpenClaw through native plugin tools.",
+  "version": "0.1.0",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "runtimeRoot": {
+        "type": "string",
+        "description": "Optional OpenSyn home directory. Defaults to ~/.opensyn and stores the database plus managed runtime assets."
+      },
+      "dbPath": {
+        "type": "string",
+        "description": "Optional absolute path to the OpenSyn SQLite database. Defaults to <runtimeRoot>/opensyn.db."
+      },
+      "cliBin": {
+        "type": "string",
+        "description": "Optional absolute path to the synapse-cli binary or OpenSyn CLI wrapper."
+      },
+      "daemonBin": {
+        "type": "string",
+        "description": "Optional absolute path to the synapse-daemon binary or OpenSyn daemon wrapper."
+      },
+      "helperPath": {
+        "type": "string",
+        "description": "Optional absolute path to the shell-hook ingest helper."
+      },
+      "runnerPath": {
+        "type": "string",
+        "description": "Optional absolute path to the command wrapper used by the shell hook."
+      },
+      "defaultShell": {
+        "type": "string",
+        "description": "Optional shell name used when plugin-managed collection repairs the local shell hook."
+      },
+      "defaultProjectRoot": {
+        "type": "string",
+        "description": "Optional default project root when the caller does not pass one."
+      },
+      "defaultWindowSecs": {
+        "type": "integer",
+        "minimum": 1,
+        "default": 300
+      },
+      "defaultSearchLimit": {
+        "type": "integer",
+        "minimum": 1,
+        "default": 10
+      },
+      "daemonTimeoutMs": {
+        "type": "integer",
+        "minimum": 1000,
+        "default": 10000,
+        "description": "Maximum time to wait for synapse-daemon before the tool call fails."
+      },
+      "projectionBundleRoot": {
+        "type": "string",
+        "description": "Optional projection root. For OpenClaw host mode this should usually be the OpenClaw workspace root, for example ~/.openclaw/workspace."
+      },
+      "projectionHost": {
+        "type": "string",
+        "description": "Optional projection host flavor: openclaw, claudecode, or generic."
+      },
+      "projectionAutoApplyApproved": {
+        "type": "boolean",
+        "description": "Optional default for whether approved assets should be projected automatically."
+      },
+      "watchIdleWindowSecs": {
+        "type": "integer",
+        "minimum": 1,
+        "description": "Optional idle window for the plugin-managed background watch-linux collector. Defaults to 10 seconds."
+      },
+      "watchPollIntervalSecs": {
+        "type": "integer",
+        "minimum": 1,
+        "description": "Optional poll interval for the plugin-managed background watch-linux collector. Defaults to 2 seconds."
+      },
+      "openclawBin": {
+        "type": "string",
+        "description": "Optional path to the OpenClaw CLI used by the plugin-managed host-model distillation worker. Defaults to 'openclaw'."
+      },
+      "distillationWorkerEnabled": {
+        "type": "boolean",
+        "description": "Whether the plugin-managed host-model distillation worker should run automatically. Defaults to true."
+      },
+      "distillationWorkerIntervalSecs": {
+        "type": "integer",
+        "minimum": 5,
+        "description": "Optional interval for the plugin-managed host-model distillation worker. Defaults to 60 seconds."
+      },
+      "distillationWorkerAgentId": {
+        "type": "string",
+        "description": "Optional OpenClaw agent id used by the plugin-managed host-model distillation worker. Defaults to 'main'."
+      }
+    }
+  },
+  "uiHints": {
+    "dbPath": {
+      "label": "OpenSyn DB Path",
+      "placeholder": "/home/user/.opensyn/opensyn.db"
+    },
+    "runtimeRoot": {
+      "label": "OpenSyn Home",
+      "placeholder": "/home/user/.opensyn"
+    },
+    "cliBin": {
+      "label": "OpenSyn CLI Path",
+      "placeholder": "/path/to/opensyn-cli"
+    },
+    "daemonBin": {
+      "label": "OpenSyn Daemon Path",
+      "placeholder": "/path/to/opensyn-daemon"
+    },
+    "helperPath": {
+      "label": "Helper Path",
+      "placeholder": "/path/to/synapse-ingest-command"
+    },
+    "runnerPath": {
+      "label": "Runner Path",
+      "placeholder": "/path/to/synapse-run"
+    },
+    "defaultShell": {
+      "label": "Default Shell",
+      "placeholder": "bash"
+    },
+    "defaultProjectRoot": {
+      "label": "Default Project Root",
+      "placeholder": "/path/to/project"
+    },
+    "daemonTimeoutMs": {
+      "label": "Daemon Timeout (ms)",
+      "placeholder": "10000"
+    },
+    "projectionBundleRoot": {
+      "label": "Projection Root",
+      "placeholder": "/home/user/.openclaw/workspace"
+    },
+    "projectionHost": {
+      "label": "Projection Host",
+      "placeholder": "openclaw"
+    },
+    "projectionAutoApplyApproved": {
+      "label": "Auto Apply Approved Assets",
+      "placeholder": "false"
+    },
+    "watchIdleWindowSecs": {
+      "label": "Background Idle Window (s)",
+      "placeholder": "10"
+    },
+    "watchPollIntervalSecs": {
+      "label": "Background Poll Interval (s)",
+      "placeholder": "2"
+    },
+    "openclawBin": {
+      "label": "OpenClaw CLI Path",
+      "placeholder": "openclaw"
+    },
+    "distillationWorkerEnabled": {
+      "label": "Host Distillation Worker",
+      "placeholder": "true"
+    },
+    "distillationWorkerIntervalSecs": {
+      "label": "Worker Interval (s)",
+      "placeholder": "60"
+    },
+    "distillationWorkerAgentId": {
+      "label": "Worker Agent Id",
+      "placeholder": "main"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "opensyn",
+  "version": "0.1.0",
+  "description": "OpenClaw plugin for OpenSyn autonomous local collection, distillation, and host overlay projection.",
+  "type": "module",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "index.ts",
+    "openclaw.plugin.json",
+    "README.md",
+    "README.zh-CN.md",
+    "runtime/**/*"
+  ],
+  "scripts": {
+    "postinstall": "node ./runtime/postinstall.mjs",
+    "prepack": "cargo build --manifest-path ../../Cargo.toml -p synapse-daemon -p synapse-cli --release && bash ../../scripts/stage-opensyn-plugin-runtime --profile release --plugin-dir \"$PWD\"",
+    "release:check": "npm pack --dry-run",
+    "release:publish": "npm publish --access public",
+    "stage:runtime:debug": "bash ../../scripts/stage-opensyn-plugin-runtime --profile debug --plugin-dir \"$PWD\"",
+    "stage:runtime:release": "bash ../../scripts/stage-opensyn-plugin-runtime --profile release --plugin-dir \"$PWD\""
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.41"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ]
+  }
+}

package/runtime/opensyn-cli

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+platform="$(uname -s | tr '[:upper:]' '[:lower:]')"
+arch_raw="$(uname -m)"
+case "$arch_raw" in
+  x86_64|amd64)
+    arch="x64"
+    ;;
+  aarch64|arm64)
+    arch="arm64"
+    ;;
+  *)
+    arch="$arch_raw"
+    ;;
+esac
+
+candidates=()
+if [[ -n "${OPENSYN_CLI_BIN:-}" ]]; then
+  candidates+=("${OPENSYN_CLI_BIN}")
+fi
+
+candidates+=(
+  "$script_dir/bin/${platform}-${arch}/synapse-cli"
+  "$script_dir/bin/synapse-cli"
+  "$script_dir/../../../target/debug/synapse-cli"
+  "$script_dir/../../../target/release/synapse-cli"
+)
+
+for candidate in "${candidates[@]}"; do
+  if [[ -n "$candidate" && -x "$candidate" ]]; then
+    exec "$candidate" "$@"
+  fi
+done
+
+echo "OpenSyn CLI runtime not found. Expected one of:" >&2
+for candidate in "${candidates[@]}"; do
+  echo "  - $candidate" >&2
+done
+echo "Stage package-local binaries with scripts/stage-opensyn-plugin-runtime, or set OPENSYN_CLI_BIN." >&2
+exit 1

package/runtime/opensyn-daemon

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+platform="$(uname -s | tr '[:upper:]' '[:lower:]')"
+arch_raw="$(uname -m)"
+case "$arch_raw" in
+  x86_64|amd64)
+    arch="x64"
+    ;;
+  aarch64|arm64)
+    arch="arm64"
+    ;;
+  *)
+    arch="$arch_raw"
+    ;;
+esac
+
+candidates=()
+if [[ -n "${OPENSYN_DAEMON_BIN:-}" ]]; then
+  candidates+=("${OPENSYN_DAEMON_BIN}")
+fi
+
+candidates+=(
+  "$script_dir/bin/${platform}-${arch}/synapse-daemon"
+  "$script_dir/bin/synapse-daemon"
+  "$script_dir/../../../target/debug/synapse-daemon"
+  "$script_dir/../../../target/release/synapse-daemon"
+)
+
+for candidate in "${candidates[@]}"; do
+  if [[ -n "$candidate" && -x "$candidate" ]]; then
+    exec "$candidate" "$@"
+  fi
+done
+
+echo "OpenSyn daemon runtime not found. Expected one of:" >&2
+for candidate in "${candidates[@]}"; do
+  echo "  - $candidate" >&2
+done
+echo "Stage package-local binaries with scripts/stage-opensyn-plugin-runtime, or set OPENSYN_DAEMON_BIN." >&2
+exit 1

package/runtime/opensyn-host-distiller.mjs

@@ -0,0 +1,173 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+
+function parseArgs(argv) {
+  const options = {
+    openclawBin: "openclaw",
+    agentId: "main",
+    intervalSecs: 60,
+    timeoutSecs: 120,
+    projectRoot: process.cwd(),
+    statePath: "",
+  };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    const next = argv[i + 1];
+    if (arg === "--openclaw-bin" && next) {
+      options.openclawBin = next;
+      i += 1;
+    } else if (arg === "--agent-id" && next) {
+      options.agentId = next;
+      i += 1;
+    } else if (arg === "--interval-secs" && next) {
+      options.intervalSecs = Number.parseInt(next, 10) || options.intervalSecs;
+      i += 1;
+    } else if (arg === "--timeout-secs" && next) {
+      options.timeoutSecs = Number.parseInt(next, 10) || options.timeoutSecs;
+      i += 1;
+    } else if (arg === "--project-root" && next) {
+      options.projectRoot = next;
+      i += 1;
+    } else if (arg === "--state-path" && next) {
+      options.statePath = next;
+      i += 1;
+    }
+  }
+
+  return options;
+}
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function updateState(statePath, payload) {
+  if (!statePath) {
+    return;
+  }
+  let previous = {};
+  if (fs.existsSync(statePath)) {
+    try {
+      previous = JSON.parse(fs.readFileSync(statePath, "utf8"));
+    } catch {
+      previous = {};
+    }
+  }
+  fs.mkdirSync(path.dirname(statePath), { recursive: true });
+  fs.writeFileSync(
+    statePath,
+    `${JSON.stringify({ ...previous, ...payload }, null, 2)}\n`,
+    "utf8",
+  );
+}
+
+function buildPrompt(projectRoot) {
+  return [
+    `Run exactly one OpenSyn autonomous distillation cycle for project ${projectRoot}.`,
+    "Rules:",
+    "- Use only the OpenClaw-configured host model already available to this local runtime.",
+    "- Do not browse, do not call external network tools, and do not use any model outside OpenClaw.",
+    "- First call opensyn_autonomous_tick with no arguments.",
+    "- If automation_state is idle_waiting_for_activity, stop immediately.",
+    "- If automation_state is distillation_work_ready, follow cycle_plan.primary_steps in order.",
+    "- If the primary path cannot complete safely, follow cycle_plan.fallback_steps.",
+    "- Always execute cycle_plan.resume_steps before ending when they are available.",
+    "- Complete at most one queued work packet in this run.",
+    "- End with one short sentence describing the outcome.",
+  ].join("\n");
+}
+
+async function main() {
+  const options = parseArgs(process.argv.slice(2));
+  const prompt = buildPrompt(options.projectRoot);
+  const usesNodeShim =
+    options.openclawBin.endsWith(".mjs") || options.openclawBin.endsWith(".js");
+  let stopped = false;
+
+  process.on("SIGTERM", () => {
+    stopped = true;
+  });
+  process.on("SIGINT", () => {
+    stopped = true;
+  });
+
+  while (!stopped) {
+    const startedAt = new Date().toISOString();
+    const command = usesNodeShim ? process.execPath : options.openclawBin;
+    const commandArgs = usesNodeShim
+      ? [
+          options.openclawBin,
+          "agent",
+          "--local",
+          "--agent",
+          options.agentId,
+          "--thinking",
+          "minimal",
+          "--timeout",
+          String(options.timeoutSecs),
+          "--message",
+          prompt,
+          "--json",
+        ]
+      : [
+          "agent",
+          "--local",
+          "--agent",
+          options.agentId,
+          "--thinking",
+          "minimal",
+          "--timeout",
+          String(options.timeoutSecs),
+          "--message",
+          prompt,
+          "--json",
+        ];
+    const result = spawnSync(
+      command,
+      commandArgs,
+      {
+        cwd: options.projectRoot,
+        env: process.env,
+        encoding: "utf8",
+      },
+    );
+
+    const finishedAt = new Date().toISOString();
+    const payload = {
+      started_at: startedAt,
+      finished_at: finishedAt,
+      command,
+      command_args: commandArgs,
+      exit_code: result.status,
+      signal: result.signal,
+      error: result.error ? String(result.error.message || result.error) : "",
+      stdout: result.stdout?.trim() || "",
+      stderr: result.stderr?.trim() || "",
+    };
+    updateState(options.statePath, {
+      last_started_at: startedAt,
+      last_finished_at: finishedAt,
+      last_exit_code: result.status,
+      last_signal: result.signal,
+      last_error: payload.error || payload.stderr || "",
+      last_stdout: payload.stdout,
+      last_command: payload.command,
+      last_command_args: payload.command_args,
+    });
+    process.stdout.write(`${JSON.stringify(payload)}\n`);
+
+    if (stopped) {
+      break;
+    }
+    await sleep(Math.max(5, options.intervalSecs) * 1000);
+  }
+}
+
+main().catch((error) => {
+  process.stderr.write(`${error instanceof Error ? error.stack || error.message : String(error)}\n`);
+  process.exitCode = 1;
+});

package/runtime/opensyn-ingest-command

@@ -0,0 +1,124 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+db=""
+daemon_bin=""
+cwd=""
+command_line=""
+exit_code=""
+project_root=""
+source_kind="${OPENSYN_SOURCE_KIND:-host}"
+device_id="${OPENSYN_DEVICE_ID:-}"
+stdout_tail="${OPENSYN_STDOUT_TAIL:-}"
+stderr_tail="${OPENSYN_STDERR_TAIL:-}"
+stdout_file=""
+stderr_file=""
+max_bytes="${OPENSYN_MAX_TAIL_BYTES:-4000}"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --db)
+      db="$2"
+      shift 2
+      ;;
+    --daemon-bin)
+      daemon_bin="$2"
+      shift 2
+      ;;
+    --cwd)
+      cwd="$2"
+      shift 2
+      ;;
+    --command-line)
+      command_line="$2"
+      shift 2
+      ;;
+    --exit-code)
+      exit_code="$2"
+      shift 2
+      ;;
+    --project-root)
+      project_root="$2"
+      shift 2
+      ;;
+    --source-kind)
+      source_kind="$2"
+      shift 2
+      ;;
+    --device-id)
+      device_id="$2"
+      shift 2
+      ;;
+    --stdout-tail)
+      stdout_tail="$2"
+      shift 2
+      ;;
+    --stderr-tail)
+      stderr_tail="$2"
+      shift 2
+      ;;
+    --stdout-file)
+      stdout_file="$2"
+      shift 2
+      ;;
+    --stderr-file)
+      stderr_file="$2"
+      shift 2
+      ;;
+    --max-bytes)
+      max_bytes="$2"
+      shift 2
+      ;;
+    *)
+      echo "unknown argument: $1" >&2
+      exit 2
+      ;;
+  esac
+done
+
+if [[ -z "$db" || -z "$daemon_bin" || -z "$cwd" || -z "$command_line" || -z "$exit_code" ]]; then
+  echo "missing required arguments" >&2
+  exit 2
+fi
+
+if [[ -z "$project_root" ]]; then
+  project_root="$cwd"
+fi
+
+if [[ -z "$stdout_tail" && -n "$stdout_file" && -f "$stdout_file" ]]; then
+  stdout_tail="$(tail -c "$max_bytes" "$stdout_file" 2>/dev/null || true)"
+fi
+
+if [[ -z "$stderr_tail" && -n "$stderr_file" && -f "$stderr_file" ]]; then
+  stderr_tail="$(tail -c "$max_bytes" "$stderr_file" 2>/dev/null || true)"
+fi
+
+payload="$(
+python3 - "$project_root" "$cwd" "$command_line" "$source_kind" "$exit_code" "$device_id" "$stdout_tail" "$stderr_tail" <<'PY'
+import json
+import shlex
+import sys
+
+project_root, cwd, command_line, source_kind, exit_code, device_id, stdout_tail, stderr_tail = sys.argv[1:]
+parts = shlex.split(command_line)
+command = parts[0] if parts else command_line
+argv = parts[1:] if parts else []
+payload = {
+    "project_root": project_root,
+    "cwd": cwd,
+    "command": command,
+    "argv": argv,
+    "source_kind": source_kind,
+    "exit_code": int(exit_code),
+}
+if stdout_tail:
+    payload["stdout_tail"] = stdout_tail
+if stderr_tail:
+    payload["stderr_tail"] = stderr_tail
+if device_id:
+    payload["device_id"] = device_id
+print(json.dumps(payload, ensure_ascii=True))
+PY
+)"
+
+"$daemon_bin" ingest-command-json --db "$db" --payload "$payload"

package/runtime/opensyn-run

@@ -0,0 +1,99 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+db=""
+daemon_bin=""
+cwd=""
+project_root=""
+source_kind="${OPENSYN_SOURCE_KIND:-host}"
+device_id="${OPENSYN_DEVICE_ID:-}"
+max_bytes="${OPENSYN_MAX_TAIL_BYTES:-4000}"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --db)
+      db="$2"
+      shift 2
+      ;;
+    --daemon-bin)
+      daemon_bin="$2"
+      shift 2
+      ;;
+    --cwd)
+      cwd="$2"
+      shift 2
+      ;;
+    --project-root)
+      project_root="$2"
+      shift 2
+      ;;
+    --source-kind)
+      source_kind="$2"
+      shift 2
+      ;;
+    --device-id)
+      device_id="$2"
+      shift 2
+      ;;
+    --)
+      shift
+      break
+      ;;
+    *)
+      echo "unknown argument: $1" >&2
+      exit 2
+      ;;
+  esac
+done
+
+if [[ -z "$db" || -z "$daemon_bin" || -z "$cwd" || $# -eq 0 ]]; then
+  echo "missing required arguments" >&2
+  exit 2
+fi
+
+if [[ -z "$project_root" ]]; then
+  project_root="$cwd"
+fi
+
+tmpdir="$(mktemp -d)"
+stdout_file="$tmpdir/stdout.log"
+stderr_file="$tmpdir/stderr.log"
+trap 'rm -rf "$tmpdir"' EXIT
+
+command_line=""
+for arg in "$@"; do
+  printf -v quoted '%q' "$arg"
+  command_line+="${command_line:+ }$quoted"
+done
+
+set +e
+(
+  cd "$cwd"
+  "$@"
+) \
+  > >(tee "$stdout_file") \
+  2> >(tee "$stderr_file" >&2)
+exit_code=$?
+set -e
+
+helper_args=(
+  --db "$db"
+  --daemon-bin "$daemon_bin"
+  --project-root "$project_root"
+  --cwd "$cwd"
+  --source-kind "$source_kind"
+  --command-line "$command_line"
+  --exit-code "$exit_code"
+  --stdout-file "$stdout_file"
+  --stderr-file "$stderr_file"
+  --max-bytes "$max_bytes"
+)
+
+if [[ -n "$device_id" ]]; then
+  helper_args+=(--device-id "$device_id")
+fi
+
+"$(dirname "$0")/opensyn-ingest-command" \
+  "${helper_args[@]}"
+
+exit "$exit_code"