agentwheel 0.20.18 → 0.20.20

package/README.md

@@ -132,6 +132,12 @@ Apply the same command with the reviewed values added as `--expected-hash <sha25
 journal, rechecks the old owner and the live artifact hash, then atomically updates only the install
 manifest. Run one target at a time; named SSH agents use the same contract through `--agent`.
 
+Use `--from-unknown-owner` instead of `--from-workspace-root` for an entry recorded as
+`workspace:unknown`. A plain file or directory whose runtime no longer matches the recorded hash is
+refused unless `--carry-drift` is passed: the dry-run prints the runtime hash, the apply also needs
+`--expected-runtime-hash <sha256>`, and the manifest keeps the recorded hash so the next install
+still reports the drift. Merge and managed-block entries never carry drift.
+
 For a one-time MCP rename, keep the legacy artifact in a dedicated cutover workspace rather than
 the canonical desired-state profile. Set the legacy manifest `stateKey` on its named agent, then
 preview one runtime at a time:
@@ -638,6 +644,11 @@ project's curated selection for a remote runtime.
 }
 ```
 
+Configured packages can opt into adapter runtimes with `"runtimes": ["claude"]`. Profile and
+named-agent plans match the declared target adapter; plain workspace commands match each package's
+configured adapter. Agents sharing an adapter receive the same package roots. Upgrade every member
+to a version supporting this field before using it in shared configuration.
+
 The import is data-only: Agentwheel resolves the package first, then reads only
 `exports.selections` from that resolved source's `.agentwheel/config.json`. It never imports the
 source project's agents, profiles, SSH fields, adapter modules, trust policy, or other workspace

package/dist/{apply-ZGCJLZMZ.js → apply-Z5GVCPA4.js}

@@ -5,9 +5,9 @@ import {
   commitManifestMetadataJournal,
   recoverPendingApply,
   uninstall
-} from "./chunk-A44XYLUT.js";
-import "./chunk-FP26KSBM.js";
-import "./chunk-GE7F76AC.js";
+} from "./chunk-45WVSUJA.js";
+import "./chunk-FGFPAZ4J.js";
+import "./chunk-BNIF3FUR.js";
 export {
   applyCombinedInstallPlan,
   applyInstallPlan,

package/dist/{chunk-A44XYLUT.js → chunk-45WVSUJA.js}

@@ -24,11 +24,11 @@ import {
   rollbackCompletedOperations,
   sourceLockPath,
   writeApplyJournal
-} from "./chunk-FP26KSBM.js";
+} from "./chunk-FGFPAZ4J.js";
 import {
   pathExists,
   writeJsonAtomic
-} from "./chunk-GE7F76AC.js";
+} from "./chunk-BNIF3FUR.js";
 
 // src/install/apply.ts
 import { execFile } from "child_process";

package/dist/{chunk-GE7F76AC.js → chunk-BNIF3FUR.js}

@@ -24,6 +24,14 @@ async function pathExists(path) {
     return false;
   }
 }
+async function removeOnFailure(path, run) {
+  try {
+    return await run();
+  } catch (error) {
+    await rm(path, { recursive: true, force: true });
+    throw error;
+  }
+}
 async function hashPath(path) {
   const stats = await stat(path);
   if (stats.isFile()) {
@@ -129,6 +137,7 @@ function isAlreadyExists(error) {
 
 export {
   pathExists,
+  removeOnFailure,
   hashPath,
   listFiles,
   isIgnoredGeneratedEntry,

package/dist/{chunk-FP26KSBM.js → chunk-FGFPAZ4J.js}

@@ -4,7 +4,7 @@ import {
   hashPath,
   pathExists,
   writeJsonAtomic
-} from "./chunk-GE7F76AC.js";
+} from "./chunk-BNIF3FUR.js";
 
 // src/install/transaction.ts
 import { createHash as createHash6 } from "crypto";
@@ -1525,6 +1525,188 @@ function readMutationPathDeclarations(operationIdInput) {
   return [...paths].sort((a, b) => a.localeCompare(b));
 }
 
+// src/adapters/claude.ts
+var claudeAdapter = {
+  name: "claude",
+  displayName: "Claude Code",
+  targets: {
+    instructions: {
+      local: { enabled: true, dest: "CLAUDE.md", mode: "managed-block" },
+      user: { enabled: true, root: "home", dest: ".claude/CLAUDE.md", mode: "managed-block" }
+    },
+    rules: {
+      local: { enabled: true, dest: ".claude/rules", formats: ["markdown-rule", "claude-markdown-rule"] },
+      user: { enabled: true, root: "home", dest: ".claude/rules", formats: ["markdown-rule", "claude-markdown-rule"] }
+    },
+    skills: {
+      local: { enabled: true, dest: ".claude/skills" },
+      user: { enabled: true, root: "home", dest: ".claude/skills" }
+    },
+    commands: {
+      local: { enabled: true, dest: ".claude/commands" },
+      user: { enabled: true, root: "home", dest: ".claude/commands" }
+    },
+    subagents: {
+      local: { enabled: true, dest: ".claude/agents" },
+      user: { enabled: true, root: "home", dest: ".claude/agents" }
+    },
+    plugins: {
+      local: { enabled: true, dest: ".agentwheel/plugins/claude", semantic: "claude-plugin" },
+      user: { enabled: true, root: "home", dest: ".agentwheel/plugins/claude", semantic: "claude-plugin" }
+    },
+    mcp: {
+      local: { enabled: true, dest: ".mcp.json", merge: "json-deep" }
+    },
+    hooks: {
+      local: { enabled: true, dest: ".claude/settings.json", merge: "json-deep" },
+      user: { enabled: true, root: "home", dest: ".claude/settings.json", merge: "json-deep" }
+    },
+    settings: {
+      local: { enabled: true, dest: ".claude/settings.json", merge: "json-deep" },
+      user: { enabled: true, root: "home", dest: ".claude/settings.json", merge: "json-deep" }
+    }
+  }
+};
+
+// src/adapters/copilot.ts
+var copilotAdapter = {
+  name: "copilot",
+  displayName: "GitHub Copilot CLI",
+  targets: {
+    instructions: {
+      local: { enabled: true, dest: ".github/copilot-instructions.md", mode: "managed-block" },
+      user: { enabled: true, root: "home", dest: ".copilot/copilot-instructions.md", mode: "managed-block" }
+    },
+    rules: {
+      local: { enabled: true, dest: ".github/instructions", formats: ["markdown-rule", "copilot-instruction-rule"], semantic: "copilot-instruction" },
+      user: { enabled: true, root: "home", dest: ".copilot/instructions", formats: ["markdown-rule", "copilot-instruction-rule"], semantic: "copilot-instruction" }
+    },
+    commands: {
+      local: { enabled: true, dest: ".github/prompts", semantic: "copilot-prompt" }
+    },
+    skills: {
+      local: { enabled: true, dest: ".github/skills" },
+      user: { enabled: true, root: "home", dest: ".copilot/skills" }
+    },
+    plugins: {
+      user: { enabled: true, root: "home", dest: ".agentwheel/plugins/copilot", semantic: "copilot-plugin" }
+    },
+    subagents: {
+      local: { enabled: true, dest: ".github/agents", semantic: "copilot-agent" },
+      user: { enabled: true, root: "home", dest: ".copilot/agents", semantic: "copilot-agent" }
+    },
+    mcp: {
+      local: { enabled: true, dest: ".github/mcp.json", merge: "json-deep" },
+      user: { enabled: true, root: "home", dest: ".copilot/mcp-config.json", merge: "json-deep" }
+    },
+    hooks: {
+      local: { enabled: true, dest: ".github/hooks" },
+      user: { enabled: true, root: "home", dest: ".copilot/hooks" }
+    },
+    settings: {
+      local: { enabled: true, dest: ".github/settings.json", merge: "json-deep" },
+      user: { enabled: true, root: "home", dest: ".copilot/settings.json", merge: "json-deep" }
+    }
+  }
+};
+
+// src/adapters/codex.ts
+var codexAdapter = {
+  name: "codex",
+  displayName: "Codex CLI",
+  targets: {
+    instructions: {
+      local: { enabled: true, dest: "AGENTS.md", mode: "managed-block" },
+      user: { enabled: true, root: "home", dest: ".codex/AGENTS.md", mode: "managed-block" }
+    },
+    skills: {
+      local: { enabled: true, dest: ".agents/skills" },
+      user: { enabled: true, root: "home", dest: ".agents/skills" }
+    },
+    plugins: {
+      local: { enabled: true, dest: ".agentwheel/plugins/codex", semantic: "codex-plugin" },
+      user: { enabled: true, root: "home", dest: ".agentwheel/plugins/codex", semantic: "codex-plugin" }
+    },
+    subagents: {
+      local: { enabled: true, dest: ".codex/agents", semantic: "codex-subagent" },
+      user: { enabled: true, root: "home", dest: ".codex/agents", semantic: "codex-subagent" }
+    },
+    mcp: {
+      local: { enabled: true, dest: ".codex/config.toml", merge: "codex-toml-mcp" },
+      user: { enabled: true, root: "home", dest: ".codex/config.toml", merge: "codex-toml-mcp" }
+    },
+    hooks: {
+      local: { enabled: true, dest: ".codex/hooks.json", merge: "json-deep" },
+      user: { enabled: true, root: "home", dest: ".codex/hooks.json", merge: "json-deep" }
+    }
+  }
+};
+
+// src/adapters/hermes.ts
+var hermesAdapter = {
+  name: "hermes",
+  displayName: "Hermes",
+  targets: {
+    instructions: {
+      local: { enabled: true, dest: "AGENTS.md", mode: "managed-block" },
+      // Hermes documents SOUL.md as the user-level instruction surface.
+      user: { enabled: true, root: "home", dest: ".hermes/SOUL.md", mode: "managed-block" }
+    },
+    skills: {
+      user: { enabled: true, root: "home", dest: ".hermes/skills" }
+    },
+    mcp: {
+      user: { enabled: true, root: "home", dest: ".hermes/config.yaml", merge: "yaml-deep" }
+    },
+    settings: {
+      user: { enabled: true, root: "home", dest: ".hermes/config.yaml", merge: "yaml-deep" }
+    },
+    plugins: {
+      user: { enabled: true, root: "home", dest: ".agentwheel/plugins/hermes", semantic: "hermes-plugin" }
+    }
+  }
+};
+
+// src/adapters/openclaw.ts
+var openClawAdapter = {
+  name: "openclaw",
+  displayName: "OpenClaw",
+  targets: {
+    instructions: {
+      user: { enabled: true, root: "home", dest: ".openclaw/workspace/AGENTS.md", mode: "managed-block" }
+    },
+    skills: {
+      local: { enabled: true, dest: "skills" },
+      user: { enabled: true, root: "home", dest: ".openclaw/skills" }
+    },
+    subagents: {
+      user: { enabled: true, root: "home", dest: ".openclaw/workspace-subagents", semantic: "openclaw-subagent" }
+    },
+    mcp: {
+      user: { enabled: true, root: "home", dest: ".openclaw/openclaw.json", merge: "openclaw-json-deep" }
+    },
+    settings: {
+      user: { enabled: true, root: "home", dest: ".openclaw/openclaw.json", merge: "openclaw-json-deep" }
+    },
+    plugins: {
+      local: { enabled: true, dest: ".openclaw/plugins", formats: ["openclaw-plugin", "openclaw-clawhub-plugin"], semantic: "openclaw-plugin" }
+    }
+  }
+};
+
+// src/adapters/index.ts
+var adapters = [openClawAdapter, claudeAdapter, codexAdapter, hermesAdapter, copilotAdapter];
+function getAdapter(name) {
+  const adapter = adapters.find((candidate) => candidate.name === name);
+  if (!adapter) {
+    throw new Error(`Unknown adapter: ${name}`);
+  }
+  return adapter;
+}
+function listAdapters() {
+  return [...adapters];
+}
+
 // src/model/workspace.ts
 var artifactSelectorListSchema = z7.array(z7.string().min(1));
 var CURRENT_WORKSPACE_SCHEMA_VERSION = 4;
@@ -1562,6 +1744,9 @@ var workspacePackageBaseSchema = z7.object({
   source: z7.string().min(1),
   driver: z7.enum(["local", "git", "skillkit", "vercel-skills", "mcp-registry", "clawhub"]).default("local"),
   adapter: z7.string().min(1).default("openclaw"),
+  runtimes: z7.array(z7.string().min(1)).min(1).refine((runtimes) => new Set(runtimes).size === runtimes.length, {
+    message: "Package runtimes must be unique."
+  }).transform((runtimes) => [...runtimes].sort()).optional(),
   adapterConfig: z7.string().min(1).optional(),
   adapterModule: z7.string().min(1).optional(),
   adapterCodeHash: z7.string().min(16).optional(),
@@ -1726,7 +1911,25 @@ var workspaceConfigSchema = z7.discriminatedUnion("schemaVersion", [
   workspaceConfigV2Schema,
   workspaceConfigV3Schema,
   workspaceConfigV4Schema
-]);
+]).superRefine((config, ctx) => {
+  const known = /* @__PURE__ */ new Set([
+    ...listAdapters().map((adapter) => adapter.name),
+    ...Object.values(config.agents).map((agent) => agent.adapter),
+    ...Object.values(config.profiles).flatMap((profile) => "runtimes" in profile && profile.runtimes ? profile.runtimes.map((runtime) => runtime.agent ? config.agents[runtime.agent]?.adapter ?? runtime.adapter : runtime.adapter) : [])
+  ]);
+  for (const [index, pkg] of config.packages.entries()) {
+    for (const [runtimeIndex, runtime] of (pkg.runtimes ?? []).entries()) {
+      if (!known.has(runtime)) ctx.addIssue({
+        code: "custom",
+        path: ["packages", index, "runtimes", runtimeIndex],
+        message: `Unknown package runtime adapter '${runtime}'. Use a built-in adapter or an adapter declared by an agent/profile runtime.`
+      });
+    }
+  }
+});
+function packagesForTarget(packages, target, targetForPackage) {
+  return packages.filter((pkg) => !pkg.runtimes || pkg.runtimes.includes((targetForPackage?.(pkg) ?? target).adapter));
+}
 function supportsFleetConfig(config) {
   return config.schemaVersion === 3 || config.schemaVersion === 4;
 }
@@ -2865,8 +3068,8 @@ async function recoverMutationRuntime(operationId, options = {}) {
     }
     mutation = GovernedMutation.activateExisting(receipt, baseline, lock);
     const [{ recoverPendingApply }, { readLinkedLocalApplyJournal: readLinkedLocalApplyJournal2, removeApplyJournal: removeApplyJournal2, localPathExists: localPathExists2 }] = await Promise.all([
-      import("./apply-ZGCJLZMZ.js"),
-      import("./transaction-4KBNHDQX.js")
+      import("./apply-Z5GVCPA4.js"),
+      import("./transaction-NLAIJ2ZZ.js")
     ]);
     let missingReservation = false;
     for (const entry of pending) {
@@ -3361,6 +3564,7 @@ export {
   installRootForArtifacts,
   installRootForAdapterInstallationType,
   loadAdapterConfig,
+  getAdapter,
   readMutationReceipt,
   listMutationReceipts,
   declareMutationPath,
@@ -3380,6 +3584,7 @@ export {
   fleetIdSchema,
   registeredFleetSchema,
   workspaceConfigSchema,
+  packagesForTarget,
   supportsFleetConfig,
   workspaceConfigPath,
   readWorkspaceConfig,

package/dist/{chunk-U2GRG4UI.js → chunk-QABA4WUP.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   pathExists
-} from "./chunk-GE7F76AC.js";
+} from "./chunk-BNIF3FUR.js";
 
 // src/source/identify.ts
 import { homedir } from "os";

package/dist/{identify-O54QXPQR.js → identify-M6IA4RS7.js}

@@ -2,8 +2,8 @@
 import {
   inferSourceDriverName,
   isExplicitSource
-} from "./chunk-U2GRG4UI.js";
-import "./chunk-GE7F76AC.js";
+} from "./chunk-QABA4WUP.js";
+import "./chunk-BNIF3FUR.js";
 export {
   inferSourceDriverName,
   isExplicitSource