@cocorograph/hub-agent 0.4.1

package/scripts/install.sh

@@ -0,0 +1,130 @@
+#!/usr/bin/env bash
+# =============================================================================
+# hub-agent ワンライナーインストーラ (Sprint L)
+#
+# Hub の `GET /api/cockpit/agents/install-script` が、このスクリプトに
+# enrollment token + hub url を埋め込んだ personalized 版を返す。
+#
+# 単独使用 (token なし):
+#   curl -fsSL https://raw.githubusercontent.com/cocorograph/D00000_hub-agent/main/scripts/install.sh | bash
+#
+# 内容:
+#   1. macOS なら Homebrew (なければ install)
+#   2. tmux + node (なければ install via brew / apt)
+#   3. npm i -g @cocorograph/hub-agent
+#   4. HUB_AGENT_TOKEN が設定されていれば hub-agent enroll を自動実行
+#   5. hub-agent install-service で OS サービス化
+# =============================================================================
+
+set -euo pipefail
+
+NODE_MIN_MAJOR=20
+PACKAGE_NAME="@cocorograph/hub-agent"
+
+color_step() { printf "\033[1;34m==> %s\033[0m\n" "$1"; }
+color_ok()   { printf "\033[1;32m✓ %s\033[0m\n" "$1"; }
+color_warn() { printf "\033[1;33m! %s\033[0m\n" "$1"; }
+color_err()  { printf "\033[1;31m✗ %s\033[0m\n" "$1" >&2; }
+
+present() { command -v "$1" >/dev/null 2>&1; }
+
+ensure_brew() {
+  if [[ "$(uname)" != "Darwin" ]]; then return 0; fi
+  if present brew; then color_ok "brew already installed"; return 0; fi
+  color_step "Homebrew をインストール"
+  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+  # Apple Silicon の brew はデフォルト PATH に入らないので追加
+  if [[ -d /opt/homebrew/bin ]]; then
+    export PATH="/opt/homebrew/bin:$PATH"
+  fi
+  present brew || { color_err "brew install failed"; exit 1; }
+}
+
+ensure_pkg() {
+  local cmd="$1"
+  local brew_pkg="$2"
+  local apt_pkg="${3:-$brew_pkg}"
+  if present "$cmd"; then color_ok "$cmd already installed"; return 0; fi
+  color_step "$cmd をインストール"
+  if [[ "$(uname)" == "Darwin" ]]; then
+    brew install "$brew_pkg"
+  elif present apt-get; then
+    sudo apt-get update -y
+    sudo apt-get install -y "$apt_pkg"
+  elif present dnf; then
+    sudo dnf install -y "$apt_pkg"
+  elif present pacman; then
+    sudo pacman -S --noconfirm "$apt_pkg"
+  else
+    color_err "対応するパッケージマネージャ (brew/apt/dnf/pacman) が見つかりません。$cmd を手動で install してください"
+    exit 1
+  fi
+}
+
+ensure_node_version() {
+  local v
+  v=$(node --version 2>/dev/null | sed 's/^v//' | cut -d. -f1)
+  if [[ -z "$v" ]]; then
+    ensure_pkg node node nodejs
+    return
+  fi
+  if (( v < NODE_MIN_MAJOR )); then
+    color_warn "node $v は古いです (>=${NODE_MIN_MAJOR} 必須)。brew で更新を試みます"
+    if [[ "$(uname)" == "Darwin" ]]; then
+      brew upgrade node || brew install node
+    else
+      color_err "Node ${NODE_MIN_MAJOR}+ を手動で install してください (nvm 推奨)"
+      exit 1
+    fi
+  else
+    color_ok "node $v"
+  fi
+}
+
+ensure_global_install() {
+  if present hub-agent; then
+    local cur
+    cur=$(hub-agent --version 2>/dev/null || echo "unknown")
+    color_step "hub-agent (現在 $cur) を最新版にアップデート"
+    npm install -g "$PACKAGE_NAME"
+  else
+    color_step "$PACKAGE_NAME を install"
+    npm install -g "$PACKAGE_NAME"
+  fi
+  color_ok "hub-agent $(hub-agent --version)"
+}
+
+do_enroll() {
+  if [[ -z "${HUB_AGENT_TOKEN:-}" ]]; then
+    color_warn "HUB_AGENT_TOKEN が未設定。enroll は skip します"
+    color_warn "  手動で実行: hub-agent enroll <token> --hub-url ${HUB_AGENT_URL:-https://api.hub.cocorograph.com}"
+    return 0
+  fi
+  if [[ -f "$HOME/.hub/agent.json" ]]; then
+    color_warn "~/.hub/agent.json が既にあります。--force で上書きします"
+    hub-agent enroll "$HUB_AGENT_TOKEN" --hub-url "${HUB_AGENT_URL:-https://api.hub.cocorograph.com}" --force
+  else
+    hub-agent enroll "$HUB_AGENT_TOKEN" --hub-url "${HUB_AGENT_URL:-https://api.hub.cocorograph.com}"
+  fi
+}
+
+do_install_service() {
+  color_step "OS サービスとして自動起動を登録"
+  hub-agent install-service
+  color_ok "install-service 完了。ログ: ~/.hub/agent.log"
+}
+
+main() {
+  color_step "hub-agent ワンライナーセットアップを開始"
+  ensure_brew
+  ensure_pkg tmux tmux tmux
+  ensure_node_version
+  ensure_global_install
+  do_enroll
+  do_install_service
+  echo ""
+  color_ok "セットアップ完了。Hub UI で online 表示を確認してください"
+  echo "    https://hub.cocorograph.com/user/cockpit/agents"
+}
+
+main "$@"

package/src/config.mjs

@@ -0,0 +1,76 @@
+/**
+ * `~/.hub/agent.json` の読み書き。
+ *
+ * 仕様書: ナレッジ/インフラ/cockpit-hub-hosted-integration-spec (id=6080)
+ *
+ * パスは毎呼び出しで `os.homedir()` を解決する (テストで HOME を差し替え
+ * られるように)。`$HUB_AGENT_CONFIG_DIR` を export しておくと、その値が
+ * 優先される (mosh / 専用ユーザー用)。
+ */
+import { promises as fs, constants as fsConsts } from "node:fs"
+import path from "node:path"
+import os from "node:os"
+
+function resolveConfigDir() {
+  if (process.env.HUB_AGENT_CONFIG_DIR) return process.env.HUB_AGENT_CONFIG_DIR
+  return path.join(os.homedir(), ".hub")
+}
+
+export const paths = {
+  get configDir() {
+    return resolveConfigDir()
+  },
+  get configFile() {
+    return path.join(resolveConfigDir(), "agent.json")
+  },
+  get pluginsDir() {
+    return path.join(resolveConfigDir(), "plugins")
+  },
+}
+
+/** ~/.hub を作成する (chmod 700)。 */
+export async function ensureConfigDir() {
+  await fs.mkdir(paths.configDir, { recursive: true, mode: 0o700 })
+  await fs.mkdir(paths.pluginsDir, { recursive: true, mode: 0o700 })
+}
+
+/** 設定が存在するかどうか。 */
+export async function hasConfig() {
+  try {
+    await fs.access(paths.configFile, fsConsts.R_OK)
+    return true
+  } catch {
+    return false
+  }
+}
+
+/** 設定を読み込む。無い場合は null を返す。 */
+export async function readConfig() {
+  try {
+    const raw = await fs.readFile(paths.configFile, "utf-8")
+    return JSON.parse(raw)
+  } catch (err) {
+    if (err.code === "ENOENT") return null
+    throw err
+  }
+}
+
+/**
+ * 設定を保存する (chmod 600)。
+ *
+ * @param {object} config - `{ agent_id, agent_token, hub_url }`
+ */
+export async function writeConfig(config) {
+  await ensureConfigDir()
+  const payload = JSON.stringify(config, null, 2)
+  await fs.writeFile(paths.configFile, payload, { mode: 0o600 })
+}
+
+/** 設定をクリアする (agent unenroll や revoke 後)。 */
+export async function clearConfig() {
+  try {
+    await fs.unlink(paths.configFile)
+  } catch (err) {
+    if (err.code !== "ENOENT") throw err
+  }
+}

package/src/enroll.mjs

@@ -0,0 +1,75 @@
+/**
+ * `hub-agent enroll <enrollment_token>` の処理。
+ *
+ * Hub の POST /api/cockpit/agents/enroll-complete/ に hostname と token を
+ * 送って agent_id + agent_token を取得し、~/.hub/agent.json に保存する。
+ *
+ * 仕様書: ナレッジ/インフラ/cockpit-hub-hosted-integration-spec (id=6080)
+ */
+import os from "node:os"
+
+import { hasConfig, writeConfig } from "./config.mjs"
+
+const DEFAULT_HUB_URL = process.env.HUB_URL || "https://hub.cocorograph.com"
+
+/**
+ * @param {string} enrollmentToken
+ * @param {{ hubUrl?: string, hostname?: string, version?: string, force?: boolean, fetchImpl?: typeof fetch }} [opts]
+ */
+export async function enroll(enrollmentToken, opts = {}) {
+  if (!enrollmentToken) {
+    throw new Error("enrollment_token が指定されていません。")
+  }
+  if (!opts.force && (await hasConfig())) {
+    throw new Error(
+      "既に enroll 済みです。再 enroll するには --force を付けてください (旧 agent は Hub 側で revoke してから実行)。"
+    )
+  }
+  const hubUrl = (opts.hubUrl || DEFAULT_HUB_URL).replace(/\/+$/, "")
+  const hostname = opts.hostname || os.hostname()
+  const version = opts.version || "0.1.0"
+
+  const fetchImpl = opts.fetchImpl || globalThis.fetch
+  if (typeof fetchImpl !== "function") {
+    throw new Error("global fetch がありません。Node 20+ で実行してください。")
+  }
+
+  const res = await fetchImpl(`${hubUrl}/api/cockpit/agents/enroll-complete/`, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({
+      enrollment_token: enrollmentToken,
+      hostname,
+      version,
+    }),
+  })
+
+  const data = await safeJson(res)
+  if (!res.ok) {
+    const detail = data?.detail || JSON.stringify(data) || `HTTP ${res.status}`
+    throw new Error(`enroll failed: ${detail}`)
+  }
+  if (!data?.agent_id || !data?.agent_token) {
+    throw new Error(`enroll response 不正: ${JSON.stringify(data)}`)
+  }
+
+  await writeConfig({
+    agent_id: data.agent_id,
+    agent_token: data.agent_token,
+    hub_url: hubUrl,
+  })
+
+  return {
+    agent_id: data.agent_id,
+    is_primary: !!data.is_primary,
+    hub_url: hubUrl,
+  }
+}
+
+async function safeJson(res) {
+  try {
+    return await res.json()
+  } catch {
+    return null
+  }
+}

package/src/hooks.mjs

@@ -0,0 +1,68 @@
+/**
+ * Plugin hook 名と signatures の型定義 (JSDoc)。
+ *
+ * 仕様書: ナレッジ/インフラ/cockpit-hub-hosted-integration-spec (id=6080)
+ * の「プラグイン機構 > Hook 一覧」を参照。
+ *
+ * すべての hook は async で、ハンドラ毎に optional。最初に non-null を
+ * 返した plugin が採用される (`plugin-loader.mjs` 側で chain 実行)。
+ */
+
+/**
+ * @typedef {Object} HookContext
+ * @property {import('pino').Logger} logger
+ * @property {Object} config - 全体設定 (~/.hub/agent.json)
+ */
+
+export const HOOK_NAMES = Object.freeze([
+  "onAgentStart",
+  "onAgentStop",
+  "interceptPtySpawn",
+  "interceptTmuxExec",
+  "interceptSessionCreate",
+  "interceptSessionKill",
+  "filterSessions",
+  "transformChatInput",
+  "transformStatusDetection",
+])
+
+/**
+ * @typedef {Object} PtySpawnArgs
+ * @property {string} sessionName
+ * @property {number} cols
+ * @property {number} rows
+ * @property {Record<string, string>} env
+ */
+
+/**
+ * @typedef {Object} PtySpawnDecision
+ * @property {string} command
+ * @property {string[]} args
+ * @property {Record<string, string>} [env]
+ */
+
+/**
+ * @typedef {Object} TmuxExecArgs
+ * @property {string[]} args
+ * @property {Record<string, string>} env
+ */
+
+/**
+ * @typedef {Object} TmuxExecDecision
+ * @property {string} command
+ * @property {string[]} args
+ * @property {Record<string, string>} [env]
+ */
+
+/**
+ * @typedef {Object} Plugin
+ * @property {string} name
+ * @property {{
+ *   onAgentStart?: (ctx: HookContext) => Promise<void>,
+ *   onAgentStop?: (ctx: HookContext) => Promise<void>,
+ *   interceptPtySpawn?: (ctx: HookContext & PtySpawnArgs) => Promise<PtySpawnDecision | null>,
+ *   interceptTmuxExec?: (ctx: HookContext & TmuxExecArgs) => Promise<TmuxExecDecision | null>,
+ * }} hooks
+ */
+
+export default { HOOK_NAMES }