@openclawbrain/cli 0.4.10 → 0.4.12

package/dist/src/daemon.js

@@ -8,7 +8,7 @@
  * Commands:
  *   daemon start  — generate and load a launchd plist
  *   daemon stop   — unload the plist
- *   daemon status — show running/stopped + PID + last log lines
+ *   daemon status — show running/stopped + PID + launch command + last log lines
  *   daemon logs   — tail the daemon log file
  */
 import { execSync } from "node:child_process";
@@ -22,6 +22,8 @@ const LOG_ROOT_DIRNAME = "daemon";
 const DEFAULT_SCAN_ROOT_DIRNAME = "event-exports";
 const BASELINE_STATE_BASENAME = "baseline-state.json";
 const SCANNER_CHECKPOINT_BASENAME = ".openclawbrain-scanner-checkpoint.json";
+const CLI_PACKAGE_NAME = "@openclawbrain/cli";
+const CLI_BIN_NAME = "openclawbrain";
 const DEFAULT_DAEMON_COMMAND_RUNNER = (command) => execSync(command, {
     encoding: "utf8",
     stdio: "pipe",
@@ -62,15 +64,81 @@ export function buildDaemonServiceIdentity(activationRoot) {
 export function setDaemonCommandRunnerForTesting(runner) {
     daemonCommandRunner = runner ?? DEFAULT_DAEMON_COMMAND_RUNNER;
 }
-function getOpenclawbrainBinPath() {
+function readPackageMetadata(packageRoot) {
+    if (packageRoot === null) {
+        return null;
+    }
+    const packageJsonPath = path.join(packageRoot, "package.json");
+    if (!existsSync(packageJsonPath)) {
+        return null;
+    }
     try {
-        const resolved = daemonCommandRunner("which openclawbrain").trim();
-        return resolved.length > 0 ? resolved : null;
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+        const name = typeof packageJson.name === "string" && packageJson.name.trim().length > 0
+            ? packageJson.name.trim()
+            : null;
+        const version = typeof packageJson.version === "string" && packageJson.version.trim().length > 0
+            ? packageJson.version.trim()
+            : null;
+        if (name === null) {
+            return null;
+        }
+        return { name, version };
     }
     catch {
         return null;
     }
 }
+function isCliScriptPath(filePath) {
+    const basename = path.basename(filePath);
+    return basename === "cli.js" || basename === "cli.cjs" || basename === "cli.mjs";
+}
+function isNodeExecutablePath(filePath) {
+    return /^node(?:\.exe)?$/i.test(path.basename(filePath));
+}
+function isNpxCachePath(filePath) {
+    const resolvedPath = safeRealpath(path.resolve(filePath));
+    return resolvedPath.split(path.sep).includes("_npx");
+}
+function formatCommandArgument(value) {
+    return /^[A-Za-z0-9_@%+=:,./-]+$/.test(value) ? value : JSON.stringify(value);
+}
+function formatCommand(programArguments) {
+    return programArguments.map((argument) => formatCommandArgument(argument)).join(" ");
+}
+function escapePlistString(value) {
+    return value
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+function unescapePlistString(value) {
+    return value
+        .replace(/&apos;/g, "'")
+        .replace(/&quot;/g, "\"")
+        .replace(/&gt;/g, ">")
+        .replace(/&lt;/g, "<")
+        .replace(/&amp;/g, "&");
+}
+function getCommandPaths(commandName) {
+    try {
+        return daemonCommandRunner(`which -a ${commandName}`)
+            .split("\n")
+            .map((entry) => entry.trim())
+            .filter((entry) => entry.length > 0);
+    }
+    catch {
+        try {
+            const resolved = daemonCommandRunner(`command -v ${commandName}`).trim();
+            return resolved.length > 0 ? [resolved] : [];
+        }
+        catch {
+            return [];
+        }
+    }
+}
 function safeRealpath(filePath) {
     try {
         return realpathSync(filePath);
@@ -110,62 +178,129 @@ function resolveCliScriptCandidate(candidatePath) {
         return null;
     }
     const resolvedCandidate = safeRealpath(absoluteCandidate);
-    const basename = path.basename(resolvedCandidate);
-    if (basename !== "cli.js" && basename !== "cli.cjs" && basename !== "cli.mjs") {
+    if (!isCliScriptPath(resolvedCandidate)) {
         return null;
     }
     return resolvedCandidate;
 }
-function getOpenclawbrainCliScriptPath() {
+function resolveCliPackageRoot(startDir) {
+    const packageRoot = resolvePackageRoot(startDir);
+    const packageMetadata = readPackageMetadata(packageRoot);
+    if (packageMetadata?.name === CLI_PACKAGE_NAME) {
+        return packageRoot;
+    }
+    if (packageRoot !== null) {
+        const siblingCliRoot = path.join(path.dirname(packageRoot), "cli");
+        const siblingMetadata = readPackageMetadata(siblingCliRoot);
+        if (siblingMetadata?.name === CLI_PACKAGE_NAME) {
+            return siblingCliRoot;
+        }
+    }
+    return null;
+}
+function resolveDaemonPackageManagerLaunchSpec(moduleDir) {
+    const cliPackageRoot = resolveCliPackageRoot(moduleDir);
+    const cliPackageMetadata = readPackageMetadata(cliPackageRoot);
+    if (cliPackageMetadata === null) {
+        return null;
+    }
+    const npmPath = getCommandPaths("npm").find((candidate) => !isNpxCachePath(candidate)) ?? null;
+    if (npmPath === null) {
+        return null;
+    }
+    const packageSpec = cliPackageMetadata.version === null
+        ? CLI_PACKAGE_NAME
+        : `${CLI_PACKAGE_NAME}@${cliPackageMetadata.version}`;
+    return {
+        programArguments: [npmPath, "exec", "--yes", `--package=${packageSpec}`, "--", CLI_BIN_NAME],
+        runtimePath: npmPath,
+        runtimePackageSpec: packageSpec,
+    };
+}
+function getOpenclawbrainCliScriptPathCandidates() {
     const moduleFilePath = fileURLToPath(import.meta.url);
     const moduleDir = path.dirname(moduleFilePath);
     const packageRoot = resolvePackageRoot(moduleDir);
-    const candidates = [
+    return [
         process.argv[1],
         path.join(moduleDir, "cli.js"),
         packageRoot === null ? null : path.join(packageRoot, "dist", "src", "cli.js")
     ];
-    for (const candidate of candidates) {
-        const resolved = resolveCliScriptCandidate(candidate);
-        if (resolved !== null) {
-            return resolved;
-        }
+}
+function buildDaemonLaunchProgramArguments(serviceIdentity, programArguments) {
+    return [...programArguments, "watch", "--activation-root", serviceIdentity.requestedActivationRoot];
+}
+function describeDaemonProgramArguments(programArguments) {
+    if (programArguments === null || programArguments.length === 0) {
+        return {
+            configuredProgramArguments: null,
+            configuredCommand: null,
+            configuredRuntimePath: null,
+            configuredRuntimePackageSpec: null,
+            configuredRuntimeLooksEphemeral: null
+        };
     }
-    return null;
+    const runtimePath = programArguments.length >= 2 && isNodeExecutablePath(programArguments[0]) && isCliScriptPath(programArguments[1])
+        ? programArguments[1]
+        : programArguments[0];
+    const runtimePackageSpec = programArguments.find((argument) => argument.startsWith("--package="))?.slice("--package=".length) ?? null;
+    return {
+        configuredProgramArguments: programArguments,
+        configuredCommand: formatCommand(programArguments),
+        configuredRuntimePath: runtimePath,
+        configuredRuntimePackageSpec: runtimePackageSpec,
+        configuredRuntimeLooksEphemeral: runtimePath === null ? null : isNpxCachePath(runtimePath)
+    };
 }
 function resolveDaemonProgramArguments() {
-    const cliScriptPath = getOpenclawbrainCliScriptPath();
-    if (cliScriptPath !== null) {
-        return [process.execPath, cliScriptPath];
+    for (const candidate of getOpenclawbrainCliScriptPathCandidates()) {
+        const cliScriptPath = resolveCliScriptCandidate(candidate);
+        if (cliScriptPath !== null && !isNpxCachePath(cliScriptPath)) {
+            return {
+                programArguments: [process.execPath, cliScriptPath],
+                runtimePath: cliScriptPath,
+                runtimePackageSpec: null,
+            };
+        }
     }
-    const binPath = getOpenclawbrainBinPath();
-    if (binPath !== null) {
-        return [binPath];
+    const durableBinPath = getCommandPaths(CLI_BIN_NAME).find((candidate) => !isNpxCachePath(candidate)) ?? null;
+    if (durableBinPath !== null) {
+        return {
+            programArguments: [durableBinPath],
+            runtimePath: durableBinPath,
+            runtimePackageSpec: null,
+        };
+    }
+    const moduleFilePath = fileURLToPath(import.meta.url);
+    const moduleDir = path.dirname(moduleFilePath);
+    const packageManagerLaunchSpec = resolveDaemonPackageManagerLaunchSpec(moduleDir);
+    if (packageManagerLaunchSpec !== null) {
+        return packageManagerLaunchSpec;
     }
     return null;
 }
 function buildPlistXml(serviceIdentity, programArguments) {
     const logPath = serviceIdentity.logPath;
     const homeDir = getHomeDir();
-    const daemonProgramArguments = [...programArguments, "watch", "--activation-root", serviceIdentity.requestedActivationRoot]
-        .map((argument) => `    <string>${argument}</string>`)
+    const daemonProgramArguments = buildDaemonLaunchProgramArguments(serviceIdentity, programArguments)
+        .map((argument) => `    <string>${escapePlistString(argument)}</string>`)
         .join("\n");
     return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
   <key>Label</key>
-  <string>${serviceIdentity.label}</string>
+  <string>${escapePlistString(serviceIdentity.label)}</string>
   <key>ProgramArguments</key>
   <array>
 ${daemonProgramArguments}
   </array>
   <key>WorkingDirectory</key>
-  <string>${serviceIdentity.requestedActivationRoot}</string>
+  <string>${escapePlistString(serviceIdentity.requestedActivationRoot)}</string>
   <key>StandardOutPath</key>
-  <string>${logPath}</string>
+  <string>${escapePlistString(logPath)}</string>
   <key>StandardErrorPath</key>
-  <string>${logPath}</string>
+  <string>${escapePlistString(logPath)}</string>
   <key>KeepAlive</key>
   <true/>
   <key>RunAtLoad</key>
@@ -173,9 +308,9 @@ ${daemonProgramArguments}
   <key>EnvironmentVariables</key>
   <dict>
     <key>HOME</key>
-    <string>${homeDir}</string>
+    <string>${escapePlistString(homeDir)}</string>
     <key>PATH</key>
-    <string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
+    <string>${escapePlistString("/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin")}</string>
   </dict>
 </dict>
 </plist>
@@ -235,6 +370,7 @@ function getLaunchctlInfo(label) {
 function inspectManagedLearnerServiceInternal(activationRoot) {
     const serviceIdentity = buildDaemonServiceIdentity(activationRoot);
     const configuredActivationRoot = readDaemonActivationRoot(serviceIdentity.plistPath);
+    const configuredProgramArguments = readDaemonProgramArguments(serviceIdentity.plistPath);
     const info = getLaunchctlInfo(serviceIdentity.label);
     return {
         requestedActivationRoot: serviceIdentity.requestedActivationRoot,
@@ -246,6 +382,7 @@ function inspectManagedLearnerServiceInternal(activationRoot) {
         running: info.running,
         pid: info.pid,
         configuredActivationRoot,
+        ...describeDaemonProgramArguments(configuredProgramArguments),
         matchesRequestedActivationRoot: configuredActivationRoot === null
             ? null
             : canonicalizeActivationRoot(configuredActivationRoot) === serviceIdentity.canonicalActivationRoot,
@@ -262,11 +399,11 @@ function startManagedLearnerService(activationRoot) {
             inspection: inspectionBeforeStart
         };
     }
-    const programArguments = resolveDaemonProgramArguments();
-    if (programArguments === null) {
+    const launchSpec = resolveDaemonProgramArguments();
+    if (launchSpec === null) {
         return {
             ok: false,
-            message: "Failed to resolve an OpenClawBrain CLI launch command.",
+            message: "Failed to resolve an OpenClawBrain CLI launch command without pinning an npx cache path.",
             inspection: inspectionBeforeStart
         };
     }
@@ -275,7 +412,7 @@ function startManagedLearnerService(activationRoot) {
         mkdirSync(launchAgentsDir, { recursive: true });
     }
     ensureLogDir(serviceIdentity.logPath);
-    const plistContent = buildPlistXml(serviceIdentity, programArguments);
+    const plistContent = buildPlistXml(serviceIdentity, launchSpec.programArguments);
     writeFileSync(inspectionBeforeStart.plistPath, plistContent, "utf8");
     const result = launchctlLoad(inspectionBeforeStart.plistPath);
     if (!result.ok && !inspectionBeforeStart.installed) {
@@ -347,7 +484,7 @@ export function ensureManagedLearnerServiceForActivationRoot(activationRoot) {
     }
     const reason = !inspection.launchctlAvailable
         ? "launchctl_unavailable"
-        : startResult.message === "Failed to resolve an OpenClawBrain CLI launch command."
+        : startResult.message === "Failed to resolve an OpenClawBrain CLI launch command without pinning an npx cache path."
             ? "launch_command_unavailable"
             : "launch_failed";
     return {
@@ -419,19 +556,39 @@ function readOptionalJsonFile(filePath) {
         return null;
     }
 }
-function readDaemonActivationRoot(plistPath) {
+function readDaemonProgramArguments(plistPath) {
     if (!existsSync(plistPath)) {
         return null;
     }
     try {
         const plist = readFileSync(plistPath, "utf8");
-        const match = plist.match(/<string>--activation-root<\/string>\s*<string>([^<]+)<\/string>/);
-        return match?.[1] ?? null;
+        const sectionMatch = plist.match(/<key>ProgramArguments<\/key>\s*<array>([\s\S]*?)<\/array>/);
+        if (sectionMatch === null) {
+            return null;
+        }
+        const programArguments = [];
+        const stringPattern = /<string>([\s\S]*?)<\/string>/g;
+        let match = stringPattern.exec(sectionMatch[1]);
+        while (match !== null) {
+            programArguments.push(unescapePlistString(match[1]));
+            match = stringPattern.exec(sectionMatch[1]);
+        }
+        return programArguments.length > 0 ? programArguments : null;
     }
     catch {
         return null;
     }
 }
+function readDaemonActivationRoot(plistPath) {
+    const programArguments = readDaemonProgramArguments(plistPath);
+    if (programArguments !== null) {
+        const activationRootIndex = programArguments.indexOf("--activation-root");
+        if (activationRootIndex !== -1) {
+            return programArguments[activationRootIndex + 1] ?? null;
+        }
+    }
+    return null;
+}
 function getWatchStatePaths(activationRoot) {
     if (activationRoot === null) {
         return {
@@ -611,9 +768,9 @@ export function daemonStart(activationRoot, json) {
     const serviceIdentity = buildDaemonServiceIdentity(activationRoot);
     const plistPath = serviceIdentity.plistPath;
     const logPath = serviceIdentity.logPath;
-    const programArguments = resolveDaemonProgramArguments();
-    if (programArguments === null) {
-        const message = "Failed to resolve an OpenClawBrain CLI launch command. Install/build the local package or make `openclawbrain` available on PATH.";
+    const launchSpec = resolveDaemonProgramArguments();
+    if (launchSpec === null) {
+        const message = "Failed to resolve an OpenClawBrain CLI launch command without pinning an npx cache path. Install/build @openclawbrain/cli or use a durable repo/runtime checkout.";
         if (json) {
             console.log(JSON.stringify({
                 command: "daemon start",
@@ -630,6 +787,8 @@ export function daemonStart(activationRoot, json) {
         }
         return 1;
     }
+    const daemonProgramArguments = buildDaemonLaunchProgramArguments(serviceIdentity, launchSpec.programArguments);
+    const daemonLaunchDescription = describeDaemonProgramArguments(daemonProgramArguments);
     // Ensure LaunchAgents dir exists
     const launchAgentsDir = path.dirname(plistPath);
     if (!existsSync(launchAgentsDir)) {
@@ -637,7 +796,7 @@ export function daemonStart(activationRoot, json) {
     }
     ensureLogDir(logPath);
     // Write the plist
-    const plistContent = buildPlistXml(serviceIdentity, programArguments);
+    const plistContent = buildPlistXml(serviceIdentity, launchSpec.programArguments);
     writeFileSync(plistPath, plistContent, "utf8");
     // Load it
     const result = launchctlLoad(plistPath);
@@ -649,6 +808,7 @@ export function daemonStart(activationRoot, json) {
             logPath,
             activationRoot: serviceIdentity.requestedActivationRoot,
             serviceLabel: serviceIdentity.label,
+            ...daemonLaunchDescription,
             message: result.message,
         }, null, 2));
     }
@@ -659,6 +819,15 @@ export function daemonStart(activationRoot, json) {
             console.log(`  Plist: ${plistPath}`);
             console.log(`  Log:   ${logPath}`);
             console.log(`  Root:  ${serviceIdentity.requestedActivationRoot}`);
+            if (daemonLaunchDescription.configuredRuntimePath !== null) {
+                const runtimePackageSuffix = daemonLaunchDescription.configuredRuntimePackageSpec === null
+                    ? ""
+                    : ` (${daemonLaunchDescription.configuredRuntimePackageSpec})`;
+                console.log(`  Runtime: ${daemonLaunchDescription.configuredRuntimePath}${runtimePackageSuffix}`);
+            }
+            if (daemonLaunchDescription.configuredCommand !== null) {
+                console.log(`  Command: ${daemonLaunchDescription.configuredCommand}`);
+            }
         }
         else {
             console.error(`✗ ${result.message}`);
@@ -725,12 +894,14 @@ export function daemonStatus(activationRoot, json) {
     const info = getLaunchctlInfo(serviceIdentity.label);
     const lastLogLines = readLastLines(logPath, 5);
     const configuredActivationRoot = readDaemonActivationRoot(plistPath);
+    const configuredProgramArguments = readDaemonProgramArguments(plistPath);
     const requestedActivationRoot = serviceIdentity.requestedActivationRoot;
     const watchStatePaths = getWatchStatePaths(requestedActivationRoot);
     const watchState = readWatchStateSummary(requestedActivationRoot);
     const matchesRequestedActivationRoot = configuredActivationRoot === null
         ? null
         : canonicalizeActivationRoot(configuredActivationRoot) === serviceIdentity.canonicalActivationRoot;
+    const daemonLaunchDescription = describeDaemonProgramArguments(configuredProgramArguments);
     if (json) {
         console.log(JSON.stringify({
             command: "daemon status",
@@ -742,6 +913,7 @@ export function daemonStatus(activationRoot, json) {
             logPath,
             activationRoot: requestedActivationRoot,
             configuredActivationRoot,
+            ...daemonLaunchDescription,
             matchesRequestedActivationRoot,
             ...watchStatePaths,
             watchState,
@@ -766,6 +938,22 @@ export function daemonStatus(activationRoot, json) {
         if (matchesRequestedActivationRoot === false) {
             console.log("  Requested root does not match the installed daemon plist.");
         }
+        if (daemonLaunchDescription.configuredRuntimePath !== null) {
+            const runtimePackageSuffix = daemonLaunchDescription.configuredRuntimePackageSpec === null
+                ? ""
+                : ` (${daemonLaunchDescription.configuredRuntimePackageSpec})`;
+            const runtimeWarning = daemonLaunchDescription.configuredRuntimeLooksEphemeral ? " [ephemeral]" : "";
+            console.log(`  Runtime: ${daemonLaunchDescription.configuredRuntimePath}${runtimePackageSuffix}${runtimeWarning}`);
+        }
+        if (configuredProgramArguments !== null && configuredProgramArguments.length > 0) {
+            console.log(`  Program: ${configuredProgramArguments[0]}`);
+            if (configuredProgramArguments.length > 1) {
+                console.log(`  Args: ${configuredProgramArguments.slice(1).map((argument) => formatCommandArgument(argument)).join(" ")}`);
+            }
+        }
+        if (daemonLaunchDescription.configuredCommand !== null) {
+            console.log(`  Command: ${daemonLaunchDescription.configuredCommand}`);
+        }
         console.log(`  Log: ${logPath}`);
         if (watchState.scanRoot !== null) {
             console.log(`  Scan root: ${watchState.scanRoot}`);
@@ -904,7 +1092,7 @@ export function daemonHelp() {
         "Subcommands:",
         "  start   Generate a macOS launchd plist and start the daemon (runs openclawbrain watch).",
         "  stop    Stop the daemon and remove the launchd plist.",
-        "  status  Show whether the daemon is running, its PID, and recent log lines.",
+        "  status  Show whether the daemon is running, its PID, configured launch command, and recent log lines.",
         "  logs    Show the last 50 lines of the per-activation-root daemon log under ~/.openclawbrain/daemon/.",
         "",
         "Options:",

package/dist/src/index.js

@@ -887,7 +887,8 @@ export class AsyncTeacherLiveLoop {
                     ...(this.input.cadence !== undefined ? { cadence: this.input.cadence } : {}),
                     ...(learnedRoutingState.pgVersion !== undefined ? { pgVersion: learnedRoutingState.pgVersion } : {}),
                     ...(learnedRoutingState.serveTimeDecisions !== undefined ? { serveTimeDecisions: learnedRoutingState.serveTimeDecisions } : {}),
-                    ...(learnedRoutingState.baselineState !== undefined ? { baselineState: learnedRoutingState.baselineState } : {})
+                    ...(learnedRoutingState.baselineState !== undefined ? { baselineState: learnedRoutingState.baselineState } : {}),
+                    ...(this.input.activationRoot !== undefined ? { activationRoot: this.input.activationRoot } : {})
                 });
                 this.learnerState = structuredClone(learnerResult.state);
                 this.lastMaterialization = cloneAlwaysOnLearningMaterializationJobOrNull(learnerResult.materialization);
@@ -996,6 +997,7 @@ export function scanLiveEventExport(input) {
         learnedRouting: input.learnedRouting ?? true,
         state: createAlwaysOnLearningRuntimeState(),
         builtAt: normalizeIsoTimestamp(input.builtAt, "builtAt", observedAt),
+        ...(input.activationRoot !== undefined ? { activationRoot: input.activationRoot } : {}),
         ...(input.liveSliceSize !== undefined ? { liveSliceSize: input.liveSliceSize } : {}),
         ...(input.backfillSliceSize !== undefined ? { backfillSliceSize: input.backfillSliceSize } : {})
     });
@@ -4037,7 +4039,8 @@ export function runContinuousProductLoopTurn(input) {
             ...(input.sparseFeedback !== undefined ? { sparseFeedback: input.sparseFeedback } : {}),
             ...(input.liveSliceSize !== undefined ? { liveSliceSize: input.liveSliceSize } : {}),
             ...(input.backfillSliceSize !== undefined ? { backfillSliceSize: input.backfillSliceSize } : {}),
-            ...(input.cadence !== undefined ? { cadence: input.cadence } : {})
+            ...(input.cadence !== undefined ? { cadence: input.cadence } : {}),
+            activationRoot
         });
         currentState.learner = structuredClone(learnerResult.state);
         currentState.runtimePlasticity = learnerResult.state.runtimePlasticity === null ? null : structuredClone(learnerResult.state.runtimePlasticity);

package/dist/src/local-learner.d.ts

@@ -29,6 +29,7 @@ export interface CandidatePackBuildInput {
     serveTimeDecisions?: LearningSpineServeRouteDecisionLogEntryV1[];
     /** Baseline state for V2 variance reduction. */
     baselineState?: BaselineStateV1;
+    activationRoot?: string;
 }
 export interface CandidatePackFromNormalizedEventExportInput {
     packLabel: string;
@@ -45,6 +46,7 @@ export interface CandidatePackFromNormalizedEventExportInput {
     pgVersion?: "v1" | "v2";
     serveTimeDecisions?: LearningSpineServeRouteDecisionLogEntryV1[];
     baselineState?: BaselineStateV1;
+    activationRoot?: string;
 }
 export interface BuildTeacherSupervisionArtifactsInput {
     normalizedEventExport: NormalizedEventExportV1;
@@ -66,6 +68,7 @@ interface CandidatePackBridgeInputBase {
     pgVersion?: "v1" | "v2";
     serveTimeDecisions?: LearningSpineServeRouteDecisionLogEntryV1[];
     baselineState?: BaselineStateV1;
+    activationRoot?: string;
 }
 export interface CandidatePackFromNormalizedEventExportSliceInput extends CandidatePackBridgeInputBase {
     normalizedEventExportSlice: NormalizedEventExportSliceV1;
@@ -325,6 +328,7 @@ export interface AdvanceAlwaysOnLearningRuntimeInput {
     pgVersion?: "v1" | "v2";
     serveTimeDecisions?: LearningSpineServeRouteDecisionLogEntryV1[];
     baselineState?: BaselineStateV1;
+    activationRoot?: string;
 }
 export interface AlwaysOnLearningMaterializationJobV1 {
     jobId: string;