@baize-ai/core 0.2.0 → 0.3.0

package/scripts/pack-release.sh

@@ -0,0 +1,361 @@
+#!/usr/bin/env bash
+# ────────────────────────────────────────────────────────────────────────────
+# pack-release.sh — Baize A2A 套件私有交付打包脚本（D25 U4）
+#
+# 定位：baize-ai 根目录不是 git 仓库（aiagentpro 根仓库 .gitignore 忽略
+# /baize-ai/），故本脚本随 baize-core 仓库维护，运行时自动定位 baize-ai 根。
+#
+# 产出（默认 dist = <baize-ai>/dist/）：
+#   baize-a2a-<v>.tgz                 A2A channel 包（npm-pack 兼容结构：
+#                                     package/package.json 在包根，name=@baize-ai/baize-a2a；
+#                                     兼容 web 控制台上传与 `baize add --file` 两种安装）
+#   baize-admin-workspace-<v>.tgz     admin 套件源码：server 源码 + admin-ui 构建产物 +
+#                                     Dockerfile + 部署说明（自建镜像 / 自托管用）
+#   baize-admin-workspace-<v>.tar     docker save 的 admin 镜像（docker load 直接运行，推荐）
+#   INSTALL.md                        客户侧安装说明（上传 / --file 安装 + 切集群 + admin 部署）
+#
+# 用法：
+#   ./pack-release.sh [version] [dist-dir]
+#     version   版本号；缺省读取 baize-a2a/package.json 的 version
+#     dist-dir  输出目录；缺省 <baize-ai>/dist（可用环境变量 DIST_DIR 覆盖）
+#
+# 依赖：node/npm（a2a 包优先 npm pack）、docker（admin 镜像 docker save）、tar、jq
+# ────────────────────────────────────────────────────────────────────────────
+set -euo pipefail
+
+# ── 定位 baize-ai 根（本脚本位于 baize-ai/baize-core/scripts/）───────────────
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+BAIZE_AI_ROOT="${BAIZE_AI_ROOT:-$(cd "${SCRIPT_DIR}/../.." && pwd)}"
+if [ ! -f "${BAIZE_AI_ROOT}/baize-a2a/package.json" ]; then
+  echo "!! 找不到 baize-ai 根目录（期望 ${BAIZE_AI_ROOT}/baize-a2a/package.json）" >&2
+  echo "   可设置 BAIZE_AI_ROOT 指向 baize-ai 目录" >&2
+  exit 1
+fi
+A2A_DIR="${BAIZE_AI_ROOT}/baize-a2a"
+ADMIN_DIR="${BAIZE_AI_ROOT}/baize-admin-workspace"
+
+# ── 版本 ────────────────────────────────────────────────────────────────────
+VERSION="${1:-}"
+if [ -z "${VERSION}" ]; then
+  VERSION="$(jq -r '.version' "${A2A_DIR}/package.json")"
+fi
+if [[ ! "${VERSION}" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+  echo "!! 非法版本号: ${VERSION}（期望形如 0.1.0）" >&2
+  exit 1
+fi
+# 套件版本一致性：显式版本必须与 a2a / admin 两个 package.json 的 version 一致，
+# 否则产物 manifest 与文件名不符（npm pack 以 package.json 版本为准）。
+for _pkg in "${A2A_DIR}/package.json" "${ADMIN_DIR}/package.json"; do
+  _pv="$(jq -r '.version' "${_pkg}")"
+  if [ "${_pv}" != "${VERSION}" ]; then
+    echo "!! 版本不一致: ${_pkg} 声明 ${_pv}，请求打包 ${VERSION}" >&2
+    echo "   请先同步 package.json 版本，或省略版本参数使用默认版本（${_pv}）" >&2
+    exit 1
+  fi
+done
+
+DIST_DIR="${DIST_DIR:-${BAIZE_AI_ROOT}/dist}"
+if [ $# -ge 2 ] && [ -n "${2:-}" ]; then DIST_DIR="${2}"; fi
+mkdir -p "${DIST_DIR}"
+
+# 清理同版本旧产物，避免新旧混留
+rm -f "${DIST_DIR}/baize-a2a-${VERSION}.tgz" \
+      "${DIST_DIR}/baize-admin-workspace-${VERSION}.tgz" \
+      "${DIST_DIR}/baize-admin-workspace-${VERSION}.tar"
+
+TMP="$(mktemp -d "${TMPDIR:-/tmp}/pack-release.XXXXXX")"
+CREATED_NPMIGNORE=0
+cleanup() {
+  rm -rf "${TMP}"
+  if [ "${CREATED_NPMIGNORE}" = "1" ]; then
+    rm -f "${A2A_DIR}/.npmignore"
+  fi
+}
+trap cleanup EXIT
+
+log()  { printf '%s\n' "$*"; }
+step() { printf '\n==> %s\n' "$*"; }
+size() { du -h "$1" | awk '{print $1}'; }
+
+# ── 1. A2A channel 包 ───────────────────────────────────────────────────────
+build_a2a_tgz() {
+  step "打包 A2A channel 包 v${VERSION}"
+  local out="${DIST_DIR}/baize-a2a-${VERSION}.tgz"
+
+  # 优先 npm pack：临时 .npmignore 限定包内容（结束后删除，不留在 a2a 仓库）
+  if command -v npm >/dev/null 2>&1; then
+    if [ ! -f "${A2A_DIR}/.npmignore" ]; then
+      cat > "${A2A_DIR}/.npmignore" <<'EOF'
+test/
+docs/
+.npm-cache/
+*.tgz
+.gitignore
+EOF
+      CREATED_NPMIGNORE=1
+    fi
+    if (cd "${A2A_DIR}" && npm pack --json --pack-destination "${TMP}" >"${TMP}/npm-pack.json" 2>"${TMP}/npm.err"); then
+      local packed
+      packed="$(jq -r '.[0].filename // empty' "${TMP}/npm-pack.json")"
+      if [ -n "${packed}" ] && [ -f "${TMP}/${packed}" ]; then
+        # npm ≥9 的 npm pack 默认不再包含 package-lock.json —— 补回（交付规范要求
+        # package-lock.json 随包，客户安装可离线 npm ci）
+        if ! tar -tzf "${TMP}/${packed}" | grep -q '^package/package-lock.json$'; then
+          log "    npm pack 未含 package-lock.json，补回"
+          local fixdir="${TMP}/a2a-fix"
+          mkdir -p "${fixdir}"
+          tar -xzf "${TMP}/${packed}" -C "${fixdir}"
+          cp "${A2A_DIR}/package-lock.json" "${fixdir}/package/package-lock.json"
+          rm -f "${TMP}/${packed}"
+          tar -czf "${TMP}/${packed}" -C "${fixdir}" package
+        fi
+        mv "${TMP}/${packed}" "${out}"
+        log "    npm pack → ${out} ($(size "${out}"))"
+        return 0
+      fi
+      log "    npm pack 输出解析失败，降级手工打包"
+    else
+      log "    npm pack 失败（$(tail -1 "${TMP}/npm.err")），降级手工打包"
+    fi
+  else
+    log "    npm 不可用，降级手工打包（结构一致）"
+  fi
+
+  # 降级：tar 手工打包，结构与 npm pack 一致（package/ 前缀包装）
+  local stage="${TMP}/a2a-stage"
+  mkdir -p "${stage}/package"
+  cp -R "${A2A_DIR}/src" "${A2A_DIR}/scripts" "${stage}/package/"
+  cp "${A2A_DIR}/SKILL.md" "${A2A_DIR}/ecosystem.config.cjs" \
+     "${A2A_DIR}/package.json" "${A2A_DIR}/package-lock.json" "${stage}/package/"
+  if [ -f "${A2A_DIR}/README.md" ]; then
+    cp "${A2A_DIR}/README.md" "${stage}/package/"
+  fi
+  tar -czf "${out}" -C "${stage}" package
+  log "    tar 打包 → ${out} ($(size "${out}"))"
+}
+
+# ── 2. Admin 套件源码 tgz ───────────────────────────────────────────────────
+build_admin_tgz() {
+  step "打包 admin 套件源码 v${VERSION}"
+  local out="${DIST_DIR}/baize-admin-workspace-${VERSION}.tgz"
+  local stage="${TMP}/admin-stage/baize-admin-workspace-${VERSION}"
+  mkdir -p "${stage}"
+
+  cp "${ADMIN_DIR}/package.json" "${ADMIN_DIR}/package-lock.json" \
+     "${ADMIN_DIR}/Dockerfile" "${ADMIN_DIR}/README.md" "${stage}/"
+  cp -R "${ADMIN_DIR}/server" "${stage}/server"        # server 源码（src + test）
+  cp -R "${ADMIN_DIR}/scripts" "${stage}/scripts"
+  mkdir -p "${stage}/admin-ui"
+  cp -R "${ADMIN_DIR}/admin-ui/dist" "${stage}/admin-ui/dist"   # 构建产物
+  if [ -f "${ADMIN_DIR}/admin-ui/package.json" ]; then
+    cp "${ADMIN_DIR}/admin-ui/package.json" "${stage}/admin-ui/"
+  fi
+
+  tar -czf "${out}" -C "${TMP}/admin-stage" "baize-admin-workspace-${VERSION}"
+  log "    → ${out} ($(size "${out}"))"
+}
+
+# ── 3. Admin Docker 镜像（docker save）──────────────────────────────────────
+save_admin_image() {
+  step "导出 admin Docker 镜像"
+  local image="baize-admin-workspace:test"
+  if ! docker image inspect "${image}" >/dev/null 2>&1; then
+    echo "!! 镜像 ${image} 不存在（先构建：cd ${ADMIN_DIR} && docker build -t ${image} .）" >&2
+    exit 1
+  fi
+  local out="${DIST_DIR}/baize-admin-workspace-${VERSION}.tar"
+  docker save -o "${out}" "${image}"
+  log "    docker save ${image} → ${out} ($(size "${out}"))"
+}
+
+# ── 4. INSTALL.md ───────────────────────────────────────────────────────────
+write_install_md() {
+  step "生成 INSTALL.md"
+  local out="${DIST_DIR}/INSTALL.md"
+  cat > "${TMP}/INSTALL.md.tpl" <<'INSTALL_EOF'
+# Baize A2A 套件安装说明（私有交付 v__VERSION__）
+
+> 私有交付物：不通过 npm / 公开镜像分发，由厂商人工发放。
+> 适用：安装 A2A 通道包（每实例组件）+ 部署 Admin 控制面（集群控制面）。
+
+## 交付物清单
+
+| 文件 | 用途 |
+|------|------|
+| `baize-a2a-__VERSION__.tgz` | A2A 通道包（channel）。安装到本机 baize 环境：web 控制台上传 或 `baize add --file` |
+| `baize-admin-workspace-__VERSION__.tgz` | Admin 套件源码：server 源码 + admin-ui 构建产物 + Dockerfile + 部署说明（自建镜像 / 自托管用） |
+| `baize-admin-workspace-__VERSION__.tar` | Admin Docker 镜像（docker save 产物）：`docker load` 后直接运行（推荐） |
+| `INSTALL.md` | 本说明 |
+
+## 一、安装 A2A 通道包
+
+### 方式 A：web 控制台上传（推荐）
+
+1. 打开 Baize web 控制台，进入「A2A」页；
+2. 在「模块安装」区选择 `baize-a2a-__VERSION__.tgz` 并上传；
+3. 上传通过基础校验（manifest：package.json name=`@baize-ai/baize-a2a` + 版本；大小 / 路径穿越检查）后完成安装。
+
+### 方式 B：CLI（baize add --file）
+
+```bash
+baize add a2a --file baize-a2a-__VERSION__.tgz
+```
+
+校验安装：
+
+```bash
+baize a2a status
+```
+
+## 二、切集群（启用 A2A 互联）
+
+### 方式 A：web 控制台
+
+A2A 页「模式卡」→ 切换为集群 → 填写 `admin_url` / `advertise_url` → 确认。模式变为「集群·在线」。
+
+### 方式 B：CLI
+
+```bash
+baize a2a enable --admin https://<admin主机>:<端口> --advertise https://<本机>:<端口>
+baize a2a status    # 期望：集群·在线
+```
+
+说明：
+
+- `enable` = 切集群事务：写入 `mode: cluster` → 启动 daemon（PM2 优先，不可用则 nohup）→ TCP 就绪探测（≤30s）→ 注册 admin；
+- 未配置证书时自动生成自签证书（SAN 含 advertise_url 主机名 + 127.0.0.1 + localhost）；
+- 任一步失败自动回滚为单机模式，本地能力不受影响。
+
+### 切回单机
+
+```bash
+baize a2a disable    # 停 daemon，保留配置与注册数据，模式回 standalone
+```
+
+## 三、部署 Admin（控制面）
+
+### 方式 A：Docker 镜像（推荐）
+
+```bash
+docker load -i baize-admin-workspace-__VERSION__.tar
+docker run -d --name baize-admin -p 8080:8080 \
+  -v baize-admin-data:/data \
+  -e BAIZE_ADMIN_TOKEN='<初始口令>' \
+  baize-admin-workspace:test
+```
+
+- 访问 `http://<主机>:8080`，首次登录：`admin` + 初始口令（日志打印或 `BAIZE_ADMIN_TOKEN`）；
+- 登录后立即修改口令；数据全部落在 `/data` 卷（SQLite 库与签名密钥），务必持久化；
+- 公网部署建议放在 HTTPS 反代后面，`baize a2a enable --admin` 使用对外 HTTPS 地址。
+
+### 方式 B：源码套件（自建镜像 / 自托管）
+
+```bash
+tar xzf baize-admin-workspace-__VERSION__.tgz
+cd baize-admin-workspace-__VERSION__
+docker build -t baize-admin-workspace .          # 多阶段：node:22 构建 admin-ui → node:22-slim 运行
+docker run -d --name baize-admin -p 8080:8080 -v baize-admin-data:/data baize-admin-workspace
+```
+
+- 本地运行：`npm ci && npm start`（Node ≥ 20.11，默认 8080）；
+- 前端构建产物已含在 `admin-ui/dist`（容器内 `/app/dist`），可与 API 同源静态提供。
+
+## 四、卸载
+
+```bash
+baize a2a disable          # 先切回单机 / 停服务
+baize uninstall a2a confirm
+```
+
+## 五、常见问题
+
+- **上传校验失败**（manifest / 大小 / 路径穿越）：确认使用的是厂商交付的原包 `baize-a2a-__VERSION__.tgz`，未被篡改；
+- **enable 失败**：daemon 起不来或注册 admin 失败会自动回滚单机；查看 `baize a2a status` 与 daemon 日志；
+- **admin 无法连接**：确认 admin 已部署（`/healthz` 可访问）、`--admin` 地址与端口正确、网络互通。
+INSTALL_EOF
+  sed "s/__VERSION__/${VERSION}/g" "${TMP}/INSTALL.md.tpl" > "${out}"
+  log "    → ${out}"
+}
+
+# ── 5. 产物校验 ─────────────────────────────────────────────────────────────
+verify() {
+  step "校验产物"
+  local rc=0
+  local a2a_tgz="${DIST_DIR}/baize-a2a-${VERSION}.tgz"
+  local admin_tgz="${DIST_DIR}/baize-admin-workspace-${VERSION}.tgz"
+  local admin_tar="${DIST_DIR}/baize-admin-workspace-${VERSION}.tar"
+
+  # A2A tgz：可解压 + package.json 存在且 name/version 正确 + 关键文件齐全
+  if tar -tzf "${a2a_tgz}" >/dev/null 2>&1 \
+     &&  tar -tzf "${a2a_tgz}" | grep -q '^package/package.json$' \
+     && [ "$(tar -xOzf "${a2a_tgz}" package/package.json 2>/dev/null | jq -r '.name // empty')" = "@baize-ai/baize-a2a" ] \
+     && [ "$(tar -xOzf "${a2a_tgz}" package/package.json 2>/dev/null | jq -r '.version // empty')" = "${VERSION}" ]; then
+    local entries
+    entries="$(tar -tzf "${a2a_tgz}" | tr '\n' ' ')"
+    local missing=0
+    for f in package/SKILL.md package/ecosystem.config.cjs package/package-lock.json package/scripts/cli.js; do
+      case " ${entries} " in
+        *" ${f} "*) ;;
+        *) echo "    !! ${a2a_tgz} 缺少 ${f}" >&2; missing=1 ;;
+      esac
+    done
+    if [ "${missing}" = "0" ]; then
+      log "  OK  ${a2a_tgz} ($(size "${a2a_tgz}"))  解压 OK · name=@baize-ai/baize-a2a · version=${VERSION}"
+    else
+      rc=1
+    fi
+  else
+    echo "  !! ${a2a_tgz} 校验失败（解压或 manifest 不正确）" >&2
+    rc=1
+  fi
+
+  # Admin 套件 tgz：可解压 + package.json 存在且 name 正确 + 关键文件齐全
+  local admin_ent
+  admin_ent="baize-admin-workspace-${VERSION}"
+  if tar -tzf "${admin_tgz}" >/dev/null 2>&1 \
+     &&  tar -tzf "${admin_tgz}" | grep -q "^${admin_ent}/package.json$" \
+     && [ "$(tar -xOzf "${admin_tgz}" "${admin_ent}/package.json" 2>/dev/null | jq -r '.name // empty')" = "@baize-ai/baize-admin-workspace" ]; then
+    local a_entries missing2=0
+    a_entries="$(tar -tzf "${admin_tgz}" | tr '\n' ' ')"
+    for f in "${admin_ent}/Dockerfile" "${admin_ent}/README.md" "${admin_ent}/server/src/index.js" "${admin_ent}/admin-ui/dist/index.html"; do
+      case " ${a_entries} " in
+        *" ${f} "*) ;;
+        *) echo "    !! ${admin_tgz} 缺少 ${f}" >&2; missing2=1 ;;
+      esac
+    done
+    if [ "${missing2}" = "0" ]; then
+      log "  OK  ${admin_tgz} ($(size "${admin_tgz}"))  解压 OK · name=@baize-ai/baize-admin-workspace"
+    else
+      rc=1
+    fi
+  else
+    echo "  !! ${admin_tgz} 校验失败（解压或 manifest 不正确）" >&2
+    rc=1
+  fi
+
+  # docker save 产物：存在且非空
+  if [ -s "${admin_tar}" ]; then
+    log "  OK  ${admin_tar} ($(size "${admin_tar}"))  存在且非空"
+  else
+    echo "  !! ${admin_tar} 不存在或为空" >&2
+    rc=1
+  fi
+
+  [ -f "${DIST_DIR}/INSTALL.md" ] && log "  OK  ${DIST_DIR}/INSTALL.md ($(size "${DIST_DIR}/INSTALL.md"))"
+  return "${rc}"
+}
+
+# ── 执行 ────────────────────────────────────────────────────────────────────
+log "Baize A2A 套件私有交付打包"
+log "  版本: ${VERSION}   输出: ${DIST_DIR}"
+build_a2a_tgz
+build_admin_tgz
+save_admin_image
+write_install_md
+verify
+
+step "完成 — 交付物清单（${DIST_DIR}）"
+ls -lh "${DIST_DIR}"/baize-a2a-"${VERSION}".tgz \
+      "${DIST_DIR}"/baize-admin-workspace-"${VERSION}".tgz \
+      "${DIST_DIR}"/baize-admin-workspace-"${VERSION}".tar \
+      "${DIST_DIR}"/INSTALL.md

package/skills/comm-bridge/package.json

@@ -8,10 +8,14 @@
     "init": "node scripts/c4-db.js init",
     "test": "node --test scripts/__tests__/*.test.js"
   },
-  "keywords": ["baize", "ai-agent", "communication"],
+  "keywords": [
+    "baize",
+    "ai-agent",
+    "communication"
+  ],
   "author": "Baize AI",
   "license": "Apache-2.0",
   "dependencies": {
-    "better-sqlite3": "^12.6.2"
+    "better-sqlite3": "^13.0.3"
   }
-}
+}

package/skills/comm-bridge/scripts/c4-receive.js

@@ -24,7 +24,7 @@ import {
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const AM_SOCKET_PATH = path.join(ACTIVITY_MONITOR_DIR, 'am.sock');
-const ROUTER_IPC_TIMEOUT_MS = 30000;
+const ROUTER_IPC_TIMEOUT_MS = 3000;
 const STATUS_NOTICE_COOLDOWN_SECONDS = Number.parseInt(process.env.C4_STATUS_NOTICE_COOLDOWN_SECONDS || '600', 10);
 
 function printUsage() {
@@ -346,7 +346,28 @@ async function main() {
     }
   }
 
-  const route = await queryRoute(channel, endpoint, noReply);
+  // Route decision via activity-monitor IPC; on IPC failure/timeout degrade to
+  // the local health file (readHealthStatusFile) instead of blocking intake for
+  // ROUTER_IPC_TIMEOUT_MS — a slow/unresponsive monitor must not stall message
+  // delivery to C4 (D21 container test: monitor IPC took 19-25s without Claude
+  // auth, stalling every inbound message past the 20s c4-receive timeout).
+  let route;
+  try {
+    route = await queryRoute(channel, endpoint, noReply);
+  } catch {
+    const status = readHealthStatusFile();
+    const health = publicHealth(status?.health);
+    route =
+      health === 'ok'
+        ? { recovered: true, health: 'ok', fallback: true }
+        : {
+            recovered: false,
+            health,
+            reason: status?.unavailable_reason || health,
+            userMessage: buildFallbackMessage(status),
+            fallback: true,
+          };
+  }
   const replyEndpoint = noReply ? null : endpoint;
   let dbContent = content;
   const dbStatus = route.recovered ? 'pending' : 'delivered';

package/skills/scheduler/package.json

@@ -13,9 +13,9 @@
     "test": "node --test scripts/__tests__/*.test.js"
   },
   "dependencies": {
-    "better-sqlite3": "^12.6.2",
+    "better-sqlite3": "^13.0.3",
     "chrono-node": "^2.7.7",
     "cron-parser": "^4.9.0",
     "dotenv": "^16.6.1"
   }
-}
+}

package/skills/web-console/SKILL.md

@@ -60,6 +60,40 @@ Browser ──► Web Console Server ──► C4 Bridge ──► Claude
 | `/api/poll?since_id=N` | GET | Poll for new messages |
 | `/api/health` | GET | Server health check |
 
+## A2A Admin (agent card + call authorization)
+
+The web console also hosts the A2A admin surface (identity registration, peer
+directory, task board, message log). Agent card and call-authorization policy
+are persisted in the same `config.json` the baize-a2a daemon reads
+(`BAIZE_A2A_CONFIG`, default `~/baize/components/a2a/config.json`; polled every
+3s → hot reload).
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/admin/a2a/card` | GET/PUT | Agent card (name / description / skills) |
+| `/api/admin/a2a/card/skills` | GET | Installed skill catalogue for the card |
+| `/api/admin/a2a/authz` | GET/PUT | Call-authorization policy (see below) |
+
+### Authz policy semantics
+
+```jsonc
+// config.json "authz" field
+"authz": {
+  "mode": "open",          // "open" | "allowlist"
+  "allow": ["<agent_id>"], // allowlist mode: peers allowed to call
+  "block": ["<agent_id>"]  // open mode: peers blocked from calling
+}
+```
+
+- `open` (default): accept every approved agent except the `block` list.
+- `allowlist`: only the `allow` list may call (empty list = nobody may call).
+- The check applies to calls from other agents (message/task/cancel); query
+  endpoints keep their existing caller matching.
+- `PUT /api/admin/a2a/authz` validates: `mode` must be `open` or `allowlist`;
+  `allow`/`block` must be arrays of non-empty strings (entries are trimmed and
+  deduplicated; duplicates/empty/whitespace entries are rejected with 400).
+  Other `config.json` fields are preserved.
+
 ## Files
 
 ```

package/skills/web-console/package.json

@@ -8,7 +8,7 @@
     "start": "node server.js"
   },
   "dependencies": {
-    "better-sqlite3": "^12.6.2",
+    "better-sqlite3": "^13.0.3",
     "dotenv": "^16.6.1",
     "express": "^4.18.2",
     "multer": "^2.1.1",
@@ -18,4 +18,4 @@
     "path-to-regexp": "0.1.13",
     "qs": "6.15.2"
   }
-}
+}