agent-relay-runner 0.93.0 → 0.94.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-runner",
-  "version": "0.93.0",
+  "version": "0.94.0",
   "description": "Unified provider lifecycle runner for Agent Relay",
   "type": "module",
   "bin": {
@@ -20,7 +20,7 @@
     "directory": "runner"
   },
   "dependencies": {
-    "agent-relay-sdk": "0.2.73"
+    "agent-relay-sdk": "0.2.74"
   },
   "devDependencies": {
     "@types/bun": "latest",

package/plugins/claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-relay-runner",
   "description": "Thin Agent Relay runner bridge for Claude Code",
-  "version": "0.93.0",
+  "version": "0.94.0",
   "agentRelayContracts": {
     "providerPluginProtocol": 1
   }

package/src/launch-assembly.ts

@@ -12,6 +12,7 @@ import {
   hostUserScopeMcpServers,
   profileUsesClaudeHostProviderGlobals,
   providerHomePathFor,
+  providerProvisioningHomePathFor,
 } from "./profile-home";
 import { claudeLaunchPromptGateSettings } from "./claude-prompt-gates";
 import {
@@ -226,6 +227,7 @@ function assembleInstructions(config: RunnerSpawnConfig): AssembledInstructions
 
 function assembleClaude(config: RunnerSpawnConfig, providerConfig: ProviderConfig, hostDefaultArgs: string[]): AssembledLaunch {
   const configHome = providerHomePathFor("claude", config);
+  const assetHome = providerProvisioningHomePathFor("claude", config);
   const vanilla = profileIsVanillaBase(config);
   const projectConfigProjection = claudeProjectConfigProjectionOn(config);
   const relayPlugin = profileAllowsRelayFeature(config, "plugins");
@@ -237,14 +239,14 @@ function assembleClaude(config: RunnerSpawnConfig, providerConfig: ProviderConfi
     ? resolveClaudeProjectSkills(configHome, config, new Set(skills.map((s) => s.name)))
     : [];
   const projectSettings = resolveProjectClaudeSettings(config);
-  const provisionedPlugins = configHome ? resolveClaudeProvisionedPlugins(configHome, config) : [];
+  const provisionedPlugins = assetHome ? resolveClaudeProvisionedPlugins(assetHome, config) : [];
 
   // Plugin dirs (--plugin-dir loads explicitly, independent of --setting-sources):
   //   relay-bundled plugin → only when relay.plugins (carries the relay monitor +
   //     turn-lifecycle hooks #556, not reproducible via settings.json).
   //   relay-provisioned plugins (#556) → materialized into the isolated home.
   //   host plugin dirs → ONLY host-base profiles; isolated/vanilla must not pull them back in.
-  const relayPluginDirs = relayPlugin ? [CLAUDE_RELAY_PLUGIN_DIR] : [];
+  const relayPluginDirs = !config.agentProfile && relayPlugin ? [CLAUDE_RELAY_PLUGIN_DIR] : [];
   const provisionedPluginDirs = provisionedPlugins.map((p) => p.dir);
   const hostPluginDirs = profileUsesClaudeHostProviderGlobals(config) ? providerConfig.pluginDirs : [];
   const pluginDirs = [...new Set([...relayPluginDirs, ...provisionedPluginDirs, ...hostPluginDirs])];
@@ -350,12 +352,13 @@ function assembleClaude(config: RunnerSpawnConfig, providerConfig: ProviderConfi
 
 function assembleCodex(config: RunnerSpawnConfig, _providerConfig: ProviderConfig): AssembledLaunch {
   const configHome = providerHomePathFor("codex", config);
+  const assetHome = providerProvisioningHomePathFor("codex", config);
   const vanilla = profileIsVanillaBase(config);
   const relaySkills = profileAllowsRelayFeature(config, "skills");
   const relayEndpoint = profileAllowsRelayFeature(config, "mcp");
 
-  const provisionedSkills = configHome ? resolveCodexProvisionedSkills(configHome, config) : [];
-  const bundledSkillDirs = relaySkills ? bundledCodexSkillDirs() : [];
+  const provisionedSkills = assetHome ? resolveCodexProvisionedSkills(assetHome, config) : [];
+  const bundledSkillDirs = !config.agentProfile && relaySkills ? bundledCodexSkillDirs() : [];
   const skillDirs = [...bundledSkillDirs, ...provisionedSkills.map((s) => s.dir)];
 
   const provisionedMcp = profileProvisioning(config).mcpServers;
@@ -438,13 +441,16 @@ export function assembleLaunch(provider: SpawnProvider, config: RunnerSpawnConfi
  */
 export function materializeLaunchAssembly(provider: SpawnProvider, config: RunnerSpawnConfig): void {
   const configHome = providerHomePathFor(provider, config);
-  if (!configHome) return;
+  const assetHome = providerProvisioningHomePathFor(provider, config);
+  if (!configHome && !assetHome) return;
   if (provider === "claude") {
-    const skills = resolveClaudeProvisionedSkills(configHome, config);
-    materializeResolvedAssets(skills);
-    materializeResolvedAssets(resolveClaudeProjectSkills(configHome, config, new Set(skills.map((s) => s.name))));
-    materializeResolvedAssets(resolveClaudeProvisionedPlugins(configHome, config));
+    if (configHome) {
+      const skills = resolveClaudeProvisionedSkills(configHome, config);
+      materializeResolvedAssets(skills);
+      materializeResolvedAssets(resolveClaudeProjectSkills(configHome, config, new Set(skills.map((s) => s.name))));
+    }
+    if (assetHome) materializeResolvedAssets(resolveClaudeProvisionedPlugins(assetHome, config));
     return;
   }
-  materializeResolvedAssets(resolveCodexProvisionedSkills(configHome, config));
+  if (assetHome) materializeResolvedAssets(resolveCodexProvisionedSkills(assetHome, config));
 }

package/src/profile-home.ts

@@ -40,6 +40,15 @@ export function providerHomePathFor(provider: "claude" | "codex", config: Runner
   return providerHomePath(provider, config);
 }
 
+// Provisioned file-backed assets need a relay-owned materialization root even for
+// host-base profiles, where the provider's real config home stays in use. This path is
+// only passed explicitly through launch args such as Codex skills.config or Claude
+// --plugin-dir; it does not imply CODEX_HOME/CLAUDE_CONFIG_DIR isolation.
+export function providerProvisioningHomePathFor(provider: "claude" | "codex", config: RunnerSpawnConfig): string | undefined {
+  if (!config.agentProfile) return undefined;
+  return providerHomePathFor(provider, config) ?? join(providerHomePath(provider, config), "provisioning");
+}
+
 // First-run bootstrap (provider layer)
 // -------------------------------------
 // Isolated profile homes are keyed by instanceId, so every spawn gets a brand

package/src/profile-projection.ts

@@ -33,6 +33,7 @@ export function agentProfileProjectionReport(input: AgentProfileProjectionInput)
   add(provisioningSkillsEntry(assembled));
   add(provisioningPluginsEntry(assembled));
   add(provisioningMcpEntry(assembled));
+  for (const entry of provisioningSkippedEntries(assembled)) add(entry);
   add(projectMcpEntry(assembled));
   add(projectSkillsEntry(assembled));
   add(projectSettingsEntry(assembled));
@@ -147,6 +148,14 @@ function provisioningMcpEntry(a: AssembledLaunch): AgentProfileProjectionEntry {
     : `Relay-provisioned MCP servers emitted as -c mcp_servers.* overrides (${names.join(", ")}).`);
 }
 
+function provisioningSkippedEntries(a: AssembledLaunch): AgentProfileProjectionEntry[] {
+  return (a.profile?.provisioning?.skipped ?? []).map((item) => partial(
+    `provisioning.${item.kind}.${item.ref}`,
+    item.reason,
+    item.detail,
+  ));
+}
+
 // #667 — project `.mcp.json` projection provenance. `not-applicable` when the profile/spawn
 // didn't opt in (the default); `applied` lists the spawn-cwd servers relay injected through
 // the controlled --mcp-config / -c path (sourced from the project, not ambient host MCP).

package/src/provisioning.ts

@@ -21,7 +21,7 @@ const EMPTY: ResolvedProvisioning = { skills: [], plugins: [], mcpServers: {} };
 export function profileProvisioning(config: Pick<RunnerSpawnConfig, "agentProfile">): ResolvedProvisioning {
   const p = config.agentProfile?.provisioning;
   if (!p) return EMPTY;
-  return { skills: p.skills ?? [], plugins: p.plugins ?? [], mcpServers: p.mcpServers ?? {} };
+  return { skills: p.skills ?? [], plugins: p.plugins ?? [], mcpServers: p.mcpServers ?? {}, ...(p.skipped?.length ? { skipped: p.skipped } : {}) };
 }
 
 // The `mcpServers` keys a Claude `.mcp.json` entry may carry; coerced into the