@clawos-dev/clawd 0.2.575 → 0.2.576

package/dist/app-builder-plugin/mcp-server.cjs

@@ -21518,7 +21518,18 @@ var EnvPackageSchema = external_exports.object({
    */
   localVersion: external_exports.string().optional(),
   /** `github:` 专用——那个版本是哪个文件。见 EnvArtifactSchema */
-  artifact: EnvArtifactSchema.optional()
+  artifact: EnvArtifactSchema.optional(),
+  /**
+   * `apt:` 专用——daemon 上报时查过 Debian 12（bookworm）仓库，**没有**这个包。云上装不了，怎么办由老板在页面上定（换源 / 去掉 / 接受）；
+   * 不打回 butler（它也不见得找得到对的 npm / github 源）。有这个包时不写此字段，`version` 就是 Debian 12 会装的那一版（不是本机的）。
+   */
+  aptMissing: external_exports.literal(true).optional(),
+  /**
+   * `apt:` 专用——daemon 查到的 Debian 12 里这个包的版本（上游号，如 `3.11.2`；元包抠不出上游号时是 Debian 的版本串原样）。
+   * 是**事实**不是要求：`version` 才是构建期要验的那个——Debian 版本满足 `min`（或没 `min`）时 `version` = 它；不满足时只记这里、不钉 `version`，
+   * 页面把「Debian 12 只有 x，要求 ≥ min」摆出来让老板定。查不到（出网失败）时两者都不写，页面显示「没查到」。
+   */
+  aptVersion: external_exports.string().optional()
 });
 var EnvSecretSchema = external_exports.object({
   // 凭据的命名引用（'aliyun-ak' / 'supabase-shared'）。部署时按这个名字去解析实际的值。
@@ -24807,7 +24818,7 @@ var DEPLOY_FILE = import_node_path3.default.join(".clawd", "deploy.json");
 var SCAN_FILE = import_node_path3.default.join(".clawd", "deploy-scan.json");
 var z1 = DeployScanSchema.omit({ id: true, manifest: true }).extend({ releasedHead: DeployScanSchema.shape.head }).strict();
 var z2 = external_exports.object({ version: external_exports.literal(2), scans: external_exports.array(DeployScanSchema), released: DeployReleasedSchema.optional() }).strict();
-var PackageFindingSchema = EnvPackageSchema.omit({ localVersion: true, artifact: true }).extend({
+var PackageFindingSchema = EnvPackageSchema.omit({ localVersion: true, artifact: true, aptMissing: true, aptVersion: true }).extend({
   artifact: external_exports.object({ url: external_exports.string().url(), bin: external_exports.string() }).strict().optional()
 });
 

package/dist/cli.cjs

@@ -5989,7 +5989,7 @@ function sharedConnectorSecrets(m3) {
 function requiredSecretEnvNames(m3) {
   return [.../* @__PURE__ */ new Set([...m3.secrets.flatMap((s2) => s2.env), ...sharedConnectorSecrets(m3).flatMap((s2) => s2.env)])];
 }
-var EnvArtifactSchema, EnvPackageSchema, EnvSecretSchema, ConnectorNameSchema, CONNECTOR_KINDS, CONNECTOR_RUNNERS, CONNECTOR_PROTOCOLS, CREDENTIAL_SOURCES, CONNECTOR_AUTHS, ConnectorFieldSchema, EnvConnectorSchema, normalizeLegacyManifest, MANIFEST_BODY, EnvManifestBodySchema, EnvironmentManifestSchema, EnvEvidenceSchema;
+var EnvArtifactSchema, CLOUD_ROOT_PROVIDES, EnvPackageSchema, EnvSecretSchema, ConnectorNameSchema, CONNECTOR_KINDS, CONNECTOR_RUNNERS, CONNECTOR_PROTOCOLS, CREDENTIAL_SOURCES, CONNECTOR_AUTHS, ConnectorFieldSchema, EnvConnectorSchema, normalizeLegacyManifest, MANIFEST_BODY, EnvManifestBodySchema, EnvironmentManifestSchema, EnvEvidenceSchema;
 var init_environment_schemas = __esm({
   "../protocol/src/environment-schemas.ts"() {
     "use strict";
@@ -6001,6 +6001,7 @@ var init_environment_schemas = __esm({
       sha256: external_exports.string().regex(/^[0-9a-f]{64}$/),
       size: external_exports.number().int().positive()
     });
+    CLOUD_ROOT_PROVIDES = ["node", "npm"];
     EnvPackageSchema = external_exports.object({
       // 装完后在 PATH 里能直接调到的名字（'aliyun' / 's' / 'pnpm' / 'python3'）；npm 包报 bin 名，包名进 from
       name: external_exports.string().min(1),
@@ -6039,7 +6040,18 @@ var init_environment_schemas = __esm({
        */
       localVersion: external_exports.string().optional(),
       /** `github:` 专用——那个版本是哪个文件。见 EnvArtifactSchema */
-      artifact: EnvArtifactSchema.optional()
+      artifact: EnvArtifactSchema.optional(),
+      /**
+       * `apt:` 专用——daemon 上报时查过 Debian 12（bookworm）仓库，**没有**这个包。云上装不了，怎么办由老板在页面上定（换源 / 去掉 / 接受）；
+       * 不打回 butler（它也不见得找得到对的 npm / github 源）。有这个包时不写此字段，`version` 就是 Debian 12 会装的那一版（不是本机的）。
+       */
+      aptMissing: external_exports.literal(true).optional(),
+      /**
+       * `apt:` 专用——daemon 查到的 Debian 12 里这个包的版本（上游号，如 `3.11.2`；元包抠不出上游号时是 Debian 的版本串原样）。
+       * 是**事实**不是要求：`version` 才是构建期要验的那个——Debian 版本满足 `min`（或没 `min`）时 `version` = 它；不满足时只记这里、不钉 `version`，
+       * 页面把「Debian 12 只有 x，要求 ≥ min」摆出来让老板定。查不到（出网失败）时两者都不写，页面显示「没查到」。
+       */
+      aptVersion: external_exports.string().optional()
     });
     EnvSecretSchema = external_exports.object({
       // 凭据的命名引用（'aliyun-ak' / 'supabase-shared'）。部署时按这个名字去解析实际的值。
@@ -55654,7 +55666,7 @@ function replaceScan(file, entry) {
 function emptyDeployFile() {
   return { version: 1, manifest: { version: 1, packages: [], secrets: [], connectors: [] } };
 }
-var PackageFindingSchema = EnvPackageSchema.omit({ localVersion: true, artifact: true }).extend({
+var PackageFindingSchema = EnvPackageSchema.omit({ localVersion: true, artifact: true, aptMissing: true, aptVersion: true }).extend({
   artifact: external_exports.object({ url: external_exports.string().url(), bin: external_exports.string() }).strict().optional()
 });
 var FINDING_SCHEMAS = {
@@ -55759,6 +55771,50 @@ function downloadArtifact(exec) {
   };
 }
 
+// src/deploy/debian-apt.ts
+var DEBIAN_SUITE = "bookworm";
+var MADISON_TIMEOUT_MS = 1e4;
+function aptPackageName(from) {
+  const m3 = /^apt:([A-Za-z0-9][A-Za-z0-9+.-]*)$/.exec(from ?? "");
+  return m3?.[1];
+}
+function madisonUrl(pkg, suite = DEBIAN_SUITE) {
+  return `https://api.ftp-master.debian.org/madison?package=${encodeURIComponent(pkg)}&s=${encodeURIComponent(suite)}&a=amd64,all&text=on`;
+}
+function upstreamVersion(debianVersion) {
+  const noEpoch = debianVersion.replace(/^\d+:/, "");
+  const m3 = /^(\d+\.\d+(?:\.\d+)?)(?:[-+~]|$)/.exec(noEpoch);
+  return m3?.[1];
+}
+function parseMadison(text, pkg) {
+  for (const line of String(text).split("\n")) {
+    const cols = line.split("|").map((s2) => s2.trim());
+    if (cols.length < 3 || cols[0] !== pkg || !cols[1]) continue;
+    return { debianVersion: cols[1], upstream: upstreamVersion(cols[1]) };
+  }
+  return void 0;
+}
+function gteVersion(a2, b3) {
+  const A4 = a2.split(".").map(Number);
+  const B3 = b3.split(".").map(Number);
+  for (let i2 = 0; i2 < Math.max(A4.length, B3.length); i2++) {
+    const x2 = A4[i2] ?? 0;
+    const y3 = B3[i2] ?? 0;
+    if (x2 !== y3) return x2 > y3;
+  }
+  return true;
+}
+function lookupDebianPackage(fetchFn = fetch) {
+  return async (pkg) => {
+    const res = await fetchFn(madisonUrl(pkg), { signal: AbortSignal.timeout(MADISON_TIMEOUT_MS) });
+    if (!res.ok) throw new Error(`madison HTTP ${res.status}`);
+    return parseMadison(await res.text(), pkg);
+  };
+}
+
+// src/handlers/deploy.ts
+init_protocol();
+
 // src/deploy/repo.ts
 var import_promises6 = __toESM(require("fs/promises"), 1);
 var import_node_path35 = __toESM(require("path"), 1);
@@ -60163,8 +60219,12 @@ function buildDeployHandlers(deps) {
   };
   async function settlePackage(pkg) {
     const localVersion = await deps.probeLocalVersion(pkg);
-    const version2 = localVersion ?? pkg.version;
     const { artifact: reported, ...rest } = pkg;
+    if (pkg.from?.startsWith("apt:")) {
+      if (reported) throw invalid(`\`${pkg.name}\` \u662F apt \u6761\u76EE\uFF0C\u4E0D\u5E26 artifact\uFF08\u90A3\u662F github: \u4E13\u7528\uFF09`);
+      return settleApt(aptPackageName(pkg.from), rest, localVersion, pkg.min);
+    }
+    const version2 = localVersion ?? pkg.version;
     const out = { ...rest, ...version2 ? { version: version2 } : {}, ...localVersion ? { localVersion } : {} };
     if (!reported) return out;
     if (!pkg.version) throw invalid(`\u9489\u8D44\u4EA7\u8981\u5148\u8BF4\u6E05\u662F\u54EA\u4E2A\u7248\u672C\u7684\uFF1A\`${pkg.name}\` \u5E26 artifact \u7684\u4E0A\u62A5\u5FC5\u987B\u540C\u65F6\u5E26 version`);
@@ -60177,6 +60237,26 @@ function buildDeployHandlers(deps) {
     }
     return { ...out, artifact: { ...reported, ...verified } };
   }
+  async function settleApt(aptName, fields, localVersion, min) {
+    const { version: _agentVersion, ...rest } = fields;
+    const local = localVersion ? { localVersion } : {};
+    if (CLOUD_ROOT_PROVIDES.includes(fields.name)) return { ...rest, ...local };
+    if (!aptName) {
+      deps.warn?.("deploy.apt.badName", { from: fields.from });
+      return { ...rest, ...local };
+    }
+    let found;
+    try {
+      found = await deps.debianPackage(aptName);
+    } catch (err) {
+      deps.warn?.("deploy.apt.lookupFailed", { pkg: aptName, error: err instanceof Error ? err.message : String(err) });
+      return { ...rest, ...local };
+    }
+    if (!found) return { ...rest, ...local, aptMissing: true };
+    const aptVersion = found.upstream ?? (found.debianVersion || void 0);
+    const pin = found.upstream && !(min && !gteVersion(found.upstream, min)) ? { version: found.upstream } : {};
+    return { ...rest, ...pin, ...local, ...aptVersion ? { aptVersion } : {} };
+  }
   const reportFinding = async (frame, _client, ctx) => {
     ensureOwner(ctx);
     const args = parseArgs2(DeployReportFindingArgsSchema, frame, "deploy:reportFinding");
@@ -71503,7 +71583,7 @@ function computeMethodAccess(args) {
 }
 
 // src/version.ts
-var version = "0.2.575".length > 0 ? "0.2.575" : "dev";
+var version = "0.2.576".length > 0 ? "0.2.576" : "dev";
 
 // src/cli-probe/probe.ts
 var fs79 = __toESM(require("fs"), 1);
@@ -75173,6 +75253,8 @@ async function startDaemon(config) {
       return probeLocalVersion(runCommand, pkg);
     },
     fetchArtifact: downloadArtifact(runCommand),
+    // apt 条目的 version 按 Debian 12 仓库定（不是本机）：一次出网查 madison，只要元数据不下载
+    debianPackage: lookupDebianPackage(),
     githubIdentity,
     githubApi: (token) => createGithubApi({ token }),
     org: PERSONA_REPO_ORG,

package/dist/dispatch/mcp-server.cjs

@@ -21332,7 +21332,18 @@ var EnvPackageSchema = external_exports.object({
    */
   localVersion: external_exports.string().optional(),
   /** `github:` 专用——那个版本是哪个文件。见 EnvArtifactSchema */
-  artifact: EnvArtifactSchema.optional()
+  artifact: EnvArtifactSchema.optional(),
+  /**
+   * `apt:` 专用——daemon 上报时查过 Debian 12（bookworm）仓库，**没有**这个包。云上装不了，怎么办由老板在页面上定（换源 / 去掉 / 接受）；
+   * 不打回 butler（它也不见得找得到对的 npm / github 源）。有这个包时不写此字段，`version` 就是 Debian 12 会装的那一版（不是本机的）。
+   */
+  aptMissing: external_exports.literal(true).optional(),
+  /**
+   * `apt:` 专用——daemon 查到的 Debian 12 里这个包的版本（上游号，如 `3.11.2`；元包抠不出上游号时是 Debian 的版本串原样）。
+   * 是**事实**不是要求：`version` 才是构建期要验的那个——Debian 版本满足 `min`（或没 `min`）时 `version` = 它；不满足时只记这里、不钉 `version`，
+   * 页面把「Debian 12 只有 x，要求 ≥ min」摆出来让老板定。查不到（出网失败）时两者都不写，页面显示「没查到」。
+   */
+  aptVersion: external_exports.string().optional()
 });
 var EnvSecretSchema = external_exports.object({
   // 凭据的命名引用（'aliyun-ak' / 'supabase-shared'）。部署时按这个名字去解析实际的值。

package/dist/persona-defaults/persona-app-builder/mcp/clawd-app-builder/mcp-server.cjs

@@ -21518,7 +21518,18 @@ var EnvPackageSchema = external_exports.object({
    */
   localVersion: external_exports.string().optional(),
   /** `github:` 专用——那个版本是哪个文件。见 EnvArtifactSchema */
-  artifact: EnvArtifactSchema.optional()
+  artifact: EnvArtifactSchema.optional(),
+  /**
+   * `apt:` 专用——daemon 上报时查过 Debian 12（bookworm）仓库，**没有**这个包。云上装不了，怎么办由老板在页面上定（换源 / 去掉 / 接受）；
+   * 不打回 butler（它也不见得找得到对的 npm / github 源）。有这个包时不写此字段，`version` 就是 Debian 12 会装的那一版（不是本机的）。
+   */
+  aptMissing: external_exports.literal(true).optional(),
+  /**
+   * `apt:` 专用——daemon 查到的 Debian 12 里这个包的版本（上游号，如 `3.11.2`；元包抠不出上游号时是 Debian 的版本串原样）。
+   * 是**事实**不是要求：`version` 才是构建期要验的那个——Debian 版本满足 `min`（或没 `min`）时 `version` = 它；不满足时只记这里、不钉 `version`，
+   * 页面把「Debian 12 只有 x，要求 ≥ min」摆出来让老板定。查不到（出网失败）时两者都不写，页面显示「没查到」。
+   */
+  aptVersion: external_exports.string().optional()
 });
 var EnvSecretSchema = external_exports.object({
   // 凭据的命名引用（'aliyun-ak' / 'supabase-shared'）。部署时按这个名字去解析实际的值。
@@ -24807,7 +24818,7 @@ var DEPLOY_FILE = import_node_path3.default.join(".clawd", "deploy.json");
 var SCAN_FILE = import_node_path3.default.join(".clawd", "deploy-scan.json");
 var z1 = DeployScanSchema.omit({ id: true, manifest: true }).extend({ releasedHead: DeployScanSchema.shape.head }).strict();
 var z2 = external_exports.object({ version: external_exports.literal(2), scans: external_exports.array(DeployScanSchema), released: DeployReleasedSchema.optional() }).strict();
-var PackageFindingSchema = EnvPackageSchema.omit({ localVersion: true, artifact: true }).extend({
+var PackageFindingSchema = EnvPackageSchema.omit({ localVersion: true, artifact: true, aptMissing: true, aptVersion: true }).extend({
   artifact: external_exports.object({ url: external_exports.string().url(), bin: external_exports.string() }).strict().optional()
 });
 

package/dist/persona-defaults/persona-clawd-butler/.claude/skills/scan-persona-for-deploy/SKILL.md

@@ -129,11 +129,14 @@ call({ method: "deploy:reportFinding", args: {
 只有本机没装时才由你按官方文档填一个 `version`，并在收尾的 `notes` 里写明「本机未装 <name>，取的 x.y.z」。
 `min` 只在你确知下限时填。**不要猜版本号。**
 
-**`from` 必须能装出 `version` 那个确切版本。** 这是选源的硬规则：
-- `apt:` 只在 Debian 12 (bookworm) 仓库里有该版本时才报——去 packages.debian.org 核一眼（本机 brew 装的 jq 1.7.1，
-  bookworm 只有 1.6，那就不能报 `apt:jq`）；
-- 没有就找上游 release 走 `github:`（jq 有 GitHub release 裸二进制）；
-- 哪种都装不出本机那一版 → 写进 `notes` 作为存疑项，让老板决定。**不要报一个装出来版本不对的源。**
+**`apt:` 条目的版本由 daemon 按 Debian 12 定，你只管报 `apt:<包名>`。** apt 每个包只有 Debian 12 (bookworm) 冻结的那一个版本，
+本机 brew 装的永远比它新，「本机是啥就上云啥」对 apt 不成立。daemon 收到 `apt:` 条目会去查 Debian 官方仓库（一次元数据查询，不下载），
+把云上会装的版本写进 `version`，本机的记在 `localVersion`，页面那一行直接显示「云上装 Debian 12 的 3.11.2，本机 3.12.9」；
+Debian 12 没有这个包也照样记下（页面显示「云上装不了」）。**你不要因为版本对不上就自己换成 npm / github 源，也不要下包来验证**——
+怎么办由老板在页面上定。想先看一眼 Debian 12 有没有、是哪版，用这条（只回一行元数据）：
+`curl -s 'https://api.ftp-master.debian.org/madison?package=<包名>&s=bookworm&a=amd64,all&text=on'`，空输出就是没有。
+
+**`npm:` / `github:` 必须能装出 `version` 那个确切版本**：npm 注册表和 GitHub release 每个历史版本都在，选错了就是源选错了，不要报一个装出来版本不对的源。
 
 **`github:` 要钉资产。** GitHub 不是包注册表，从「仓库 + 版本」推不出该下哪个文件，构建器不猜。分两步：
 1. 先报 `{ name, from: "github:<owner>/<repo>" }`，从返回的 view 里读 daemon 定下的 `version`；

package/dist/persona-defaults/persona-dataclaw-builder/mcp/clawd-app-builder/mcp-server.cjs

@@ -21518,7 +21518,18 @@ var EnvPackageSchema = external_exports.object({
    */
   localVersion: external_exports.string().optional(),
   /** `github:` 专用——那个版本是哪个文件。见 EnvArtifactSchema */
-  artifact: EnvArtifactSchema.optional()
+  artifact: EnvArtifactSchema.optional(),
+  /**
+   * `apt:` 专用——daemon 上报时查过 Debian 12（bookworm）仓库，**没有**这个包。云上装不了，怎么办由老板在页面上定（换源 / 去掉 / 接受）；
+   * 不打回 butler（它也不见得找得到对的 npm / github 源）。有这个包时不写此字段，`version` 就是 Debian 12 会装的那一版（不是本机的）。
+   */
+  aptMissing: external_exports.literal(true).optional(),
+  /**
+   * `apt:` 专用——daemon 查到的 Debian 12 里这个包的版本（上游号，如 `3.11.2`；元包抠不出上游号时是 Debian 的版本串原样）。
+   * 是**事实**不是要求：`version` 才是构建期要验的那个——Debian 版本满足 `min`（或没 `min`）时 `version` = 它；不满足时只记这里、不钉 `version`，
+   * 页面把「Debian 12 只有 x，要求 ≥ min」摆出来让老板定。查不到（出网失败）时两者都不写，页面显示「没查到」。
+   */
+  aptVersion: external_exports.string().optional()
 });
 var EnvSecretSchema = external_exports.object({
   // 凭据的命名引用（'aliyun-ak' / 'supabase-shared'）。部署时按这个名字去解析实际的值。
@@ -24807,7 +24818,7 @@ var DEPLOY_FILE = import_node_path3.default.join(".clawd", "deploy.json");
 var SCAN_FILE = import_node_path3.default.join(".clawd", "deploy-scan.json");
 var z1 = DeployScanSchema.omit({ id: true, manifest: true }).extend({ releasedHead: DeployScanSchema.shape.head }).strict();
 var z2 = external_exports.object({ version: external_exports.literal(2), scans: external_exports.array(DeployScanSchema), released: DeployReleasedSchema.optional() }).strict();
-var PackageFindingSchema = EnvPackageSchema.omit({ localVersion: true, artifact: true }).extend({
+var PackageFindingSchema = EnvPackageSchema.omit({ localVersion: true, artifact: true, aptMissing: true, aptVersion: true }).extend({
   artifact: external_exports.object({ url: external_exports.string().url(), bin: external_exports.string() }).strict().optional()
 });