@farmslot/protocol 0.82.2 → 0.83.0

package/dist/node/farm-paths-storage.js

@@ -0,0 +1,54 @@
+import { readFileSync, realpathSync } from 'node:fs';
+import path from 'node:path';
+import { expandHome } from './farmslot-home.js';
+function readOptional(file) {
+    try {
+        return JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+}
+function record(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+/** Read the same configuration and durable pairing as run-bundle/retained.ts:294.
+ * Reporting never creates a store or recovers a migration.
+ */
+export function readLegacyStorageFacts(paths) {
+    const document = readOptional(path.join(path.dirname(paths.data.runBundles), 'run-bundle-retention.json'));
+    let configured;
+    if (document !== undefined) {
+        if (!record(document) || !record(document.runBundleRetention))
+            throw new Error('Invalid runBundleRetention settings.');
+        const root = document.runBundleRetention.storeRoot;
+        if (root !== undefined) {
+            if (typeof root !== 'string')
+                throw new Error('Invalid runBundleRetention.storeRoot.');
+            configured = expandHome(root);
+            if (!path.isAbsolute(configured))
+                throw new Error('runBundleRetention.storeRoot must be absolute.');
+            configured = path.resolve(configured);
+        }
+    }
+    const binding = readOptional(path.join(paths.state.runs, 'bundle-store.json'));
+    if (binding === undefined)
+        return { runBundles: configured ?? paths.data.runBundles };
+    if (!record(binding) ||
+        binding.version !== 1 ||
+        typeof binding.id !== 'string' ||
+        !binding.id ||
+        binding.runsDir !== realpathSync(paths.state.runs) ||
+        typeof binding.root !== 'string' ||
+        !path.isAbsolute(binding.root))
+        throw new Error('Run bundle store pairing does not match the canonical Run store.');
+    if (configured && realpathSync(configured) !== realpathSync(binding.root))
+        throw new Error('Run bundle store pairing does not match the configured root; use the migration command.');
+    const owner = readOptional(path.join(binding.root, 'store.json'));
+    if (!owner || JSON.stringify(owner) !== JSON.stringify(binding))
+        throw new Error('Run bundle root belongs to a different Run store.');
+    return { runBundles: binding.root };
+}
+//# sourceMappingURL=farm-paths-storage.js.map

package/dist/node/farm-paths-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"farm-paths-storage.js","sourceRoot":"","sources":["../../src/node/farm-paths-storage.ts"],"names":[],"mappings":"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"}

package/dist/node/farm-paths.d.ts

@@ -0,0 +1,149 @@
+export declare const FARM_INSTANCE_CLAIM = ".farmslot-instance";
+export type FarmRole = 'gateway' | 'node';
+export type FarmPathEnv = Readonly<Record<string, string | undefined>>;
+export interface LegacyFarmStorageFacts {
+    runBundles: string;
+}
+export interface ResolveFarmPathsOptions {
+    home?: string;
+    role: FarmRole;
+    env?: FarmPathEnv;
+    checkoutRoot?: string;
+    agentRuntimeScripts?: string;
+    userHome?: string;
+    legacyFacts?: LegacyFarmStorageFacts;
+    /** A marker read on the target by deployment tooling; null means absent. */
+    instanceConfig?: InstanceConfig | null;
+}
+export interface FarmStatePaths {
+    runs: string;
+    taskPins: string;
+    nativeSessions: string;
+    reviewWorkspaces: string;
+    sources: string;
+    nodeLink: string;
+    logs: string;
+    tmp: string;
+    cache: string;
+    gatewayLock: string;
+    sessionArchives: string;
+    episodes: string;
+    reviewWorkspaceSupport: string;
+    browserCache: string;
+    copilotRuntime: string;
+    assessmentArtifacts: string;
+    pressureHistory: string;
+    intelligenceAudit: string;
+    feedbackLedger: string;
+    extraLogDirs: string[];
+}
+export interface GatewayFarmStatePaths extends FarmStatePaths {
+    /** Legacy uses the backlog JSON file; layout 2 uses the backlog directory. */
+    backlog: string;
+    backlogFile: string;
+    roadmap: string;
+    workGraphs: string;
+    copilot: string;
+    assessments: string;
+    analytics: string;
+    backlogSpecs: string;
+    refinementPrompts: string;
+    dispatchQueue: string;
+    statusFile: string;
+    evalCaps: string;
+    observabilityAgreement: string;
+    backlogRefinementPrompts: string;
+    resourceWatchState: string;
+    capabilityStore: string;
+}
+export interface FarmCodePaths {
+    checkout: string;
+    agentRuntimeScripts: string;
+    templateNode: string;
+    node: string;
+    cli: string;
+    bin: string;
+    support: string;
+}
+export interface FarmDataPaths {
+    /** Legacy stores have no common data root; this is the selected farm home. */
+    root: string;
+    /** Legacy default candidate unless legacyFacts is supplied. Reports use resolveReportedFarmPaths. */
+    runBundles: string;
+    runArchive: string;
+    taskPinsArchive: string;
+    canary: string;
+    datasets: string;
+}
+interface SharedFarmPaths {
+    layout: 'legacy' | 2;
+    instance: string;
+    home: string;
+    /** Per-store environment variable names actually honoured, for migration warnings. */
+    envOverrides: string[];
+    config: string;
+    configFiles: {
+        sources: string;
+    };
+    pool: string;
+    projects: string;
+    templateProjects: string;
+    code: FarmCodePaths;
+    backups: string;
+    data: FarmDataPaths;
+}
+export interface NodeFarmPaths extends SharedFarmPaths {
+    role: 'node';
+    state: FarmStatePaths;
+}
+export interface GatewayFarmPaths extends SharedFarmPaths {
+    role: 'gateway';
+    state: GatewayFarmStatePaths;
+}
+export type FarmPaths = NodeFarmPaths | GatewayFarmPaths;
+/** Addressable path leaves, including indexed path arrays. Metadata is never a path. */
+export declare function farmPathEntries(paths: FarmPaths): [string, string][];
+export declare function resolveReportedFarmPaths(options: ResolveFarmPathsOptions & {
+    role: 'node';
+}): NodeFarmPaths;
+export declare function resolveReportedFarmPaths(options: ResolveFarmPathsOptions & {
+    role: 'gateway';
+}): GatewayFarmPaths;
+export declare function resolveReportedFarmPaths(options: ResolveFarmPathsOptions): FarmPaths;
+export interface InstanceConfig {
+    layout: 2;
+    name?: string;
+    dataRoot?: string;
+    ports?: FarmInstancePorts;
+}
+export interface FarmInstancePorts {
+    gateway?: number;
+}
+/** Validate a target's marker before resolving its paths on the deploying host. */
+export declare function parseFarmInstanceConfig(value: unknown, file: string): InstanceConfig;
+export declare function resolveFarmPaths(options: ResolveFarmPathsOptions & {
+    role: 'gateway';
+}): GatewayFarmPaths;
+export declare function resolveFarmPaths(options: ResolveFarmPathsOptions & {
+    role: 'node';
+}): NodeFarmPaths;
+export declare function resolveFarmPaths(options: ResolveFarmPathsOptions): FarmPaths;
+export declare function currentFarmPaths(role: 'gateway', env?: FarmPathEnv, checkoutRoot?: string): GatewayFarmPaths;
+export declare function currentFarmPaths(role: 'node', env?: FarmPathEnv, checkoutRoot?: string): NodeFarmPaths;
+/** Older nodes have no report. Keep their shell-expanded legacy paths in one place.
+ * Template expansion historically honors WORKSPACE; helper execution does not.
+ */
+export declare function legacyRemoteFarmPaths(env?: FarmPathEnv, discoveredCheckout?: string, agentRuntimeScripts?: string): {
+    home: string;
+    pool: string;
+    projects: string;
+    code: FarmCodePaths;
+    state: {
+        runs: string;
+        tmp: string;
+    };
+};
+/** Validate the optional wire report without trusting a cast at the RPC boundary. */
+export declare function isNodeFarmPaths(value: unknown): value is NodeFarmPaths;
+export {};
+//# sourceMappingURL=farm-paths.d.ts.map

package/dist/node/farm-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"farm-paths.d.ts","sourceRoot":"","sources":["../../src/node/farm-paths.ts"],"names":[],"mappings":"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"}

package/dist/node/farm-paths.js

@@ -0,0 +1,429 @@
+import { readFileSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { readLegacyStorageFacts } from './farm-paths-storage.js';
+import { expandHome } from './farmslot-home.js';
+export const FARM_INSTANCE_CLAIM = '.farmslot-instance';
+/** Addressable path leaves, including indexed path arrays. Metadata is never a path. */
+export function farmPathEntries(paths) {
+    const roots = Object.fromEntries(Object.entries(paths).filter(([key]) => !['layout', 'instance', 'role', 'envOverrides'].includes(key)));
+    function entries(value, prefix) {
+        if (typeof value === 'string')
+            return [[prefix, value]];
+        if (!value || typeof value !== 'object')
+            return [];
+        return Object.entries(value).flatMap(([key, child]) => entries(child, prefix ? `${prefix}.${key}` : key));
+    }
+    return entries(roots, '');
+}
+/** Read storage authority outside the resolver before exposing an instance report. */
+export function resolveReportedFarmPaths(options) {
+    const paths = resolveFarmPaths(options);
+    return paths.layout === 2
+        ? paths
+        : resolveFarmPaths({ ...options, legacyFacts: readLegacyStorageFacts(paths) });
+}
+function isFarmInstancePorts(value) {
+    return (!!value &&
+        typeof value === 'object' &&
+        !Array.isArray(value) &&
+        (!('gateway' in value) ||
+            (typeof value.gateway === 'number' &&
+                Number.isInteger(value.gateway) &&
+                value.gateway > 0 &&
+                value.gateway <= 65535)));
+}
+function readInstanceConfig(home) {
+    let content;
+    try {
+        content = readFileSync(path.join(home, 'config', 'instance.json'), 'utf8');
+    }
+    catch (error) {
+        // An absent marker is an unmigrated instance. Other read failures must be visible.
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+    return parseFarmInstanceConfig(JSON.parse(content), path.join(home, 'config', 'instance.json'));
+}
+/** Validate a target's marker before resolving its paths on the deploying host. */
+export function parseFarmInstanceConfig(value, file) {
+    if (!value ||
+        typeof value !== 'object' ||
+        !('layout' in value) ||
+        value.layout !== 2 ||
+        ('name' in value && (typeof value.name !== 'string' || !value.name.trim())) ||
+        ('dataRoot' in value && (typeof value.dataRoot !== 'string' || !value.dataRoot.trim())) ||
+        ('ports' in value && !isFarmInstancePorts(value.ports))) {
+        throw new Error(`Invalid farm instance config: ${file}`);
+    }
+    return {
+        layout: 2,
+        ...('name' in value && typeof value.name === 'string' ? { name: value.name } : {}),
+        ...('ports' in value && isFarmInstancePorts(value.ports) ? { ports: value.ports } : {}),
+        ...('dataRoot' in value && typeof value.dataRoot === 'string'
+            ? { dataRoot: value.dataRoot }
+            : {}),
+    };
+}
+/**
+ * Report one instance's paths without creating directories or discovering stores.
+ * Only config/instance.json is read. Legacy selectors remain in place until migration.
+ */
+export function resolveFarmPaths(options) {
+    const env = options.env ?? process.env;
+    const selectedHome = expandHome((options.home ?? env.FARMSLOT_HOME)?.trim() || path.join(homedir(), '.farmslot'));
+    const config = options.instanceConfig === undefined
+        ? readInstanceConfig(selectedHome)
+        : options.instanceConfig;
+    const home = config ? path.resolve(selectedHome) : selectedHome;
+    const instance = config?.name ?? path.basename(home).replace(/^\./u, '');
+    const envOverrides = [];
+    // Match each selector's own truthiness/nullish and path handling in legacy mode.
+    function override(name, fallback, nullish = false) {
+        const value = env[name];
+        if (nullish ? value !== undefined : !!value) {
+            envOverrides.push(name);
+            return value ?? fallback;
+        }
+        return fallback;
+    }
+    const atHome = (...parts) => path.join(home, ...parts);
+    if (config) {
+        const data = config.dataRoot ?? (env.FARMSLOT_DATA?.trim() || atHome('data'));
+        const dataRoot = path.resolve(home, expandHome(data));
+        const shared = {
+            layout: 2,
+            instance,
+            home,
+            envOverrides,
+            config: atHome('config'),
+            configFiles: { sources: atHome('config', 'sources.json') },
+            pool: atHome('pool'),
+            projects: atHome('projects'),
+            templateProjects: atHome('projects'),
+            code: {
+                checkout: atHome('code', 'node'),
+                agentRuntimeScripts: options.agentRuntimeScripts ??
+                    atHome('code', 'node', 'packages', 'agent-runtime', 'scripts'),
+                templateNode: atHome('code', 'node'),
+                node: atHome('code', 'node'),
+                cli: atHome('code', 'cli'),
+                bin: atHome('code', 'bin'),
+                support: atHome('code', 'support'),
+            },
+            backups: atHome('backups'),
+            data: {
+                root: dataRoot,
+                runBundles: path.join(dataRoot, 'run-bundles'),
+                runArchive: path.join(dataRoot, 'run-archive'),
+                taskPinsArchive: path.join(dataRoot, 'task-pins-archive'),
+                canary: path.join(dataRoot, 'canary'),
+                datasets: path.join(dataRoot, 'datasets'),
+            },
+        };
+        const state = {
+            runs: atHome('state', 'runs'),
+            taskPins: atHome('state', 'task-pins'),
+            nativeSessions: atHome('state', 'native-sessions'),
+            reviewWorkspaces: atHome('state', 'review-workspaces'),
+            sources: atHome('state', 'sources'),
+            nodeLink: atHome('state', 'node-link'),
+            logs: atHome('state', 'logs'),
+            tmp: atHome('state', 'tmp'),
+            cache: atHome('state', 'cache'),
+            gatewayLock: atHome('state', 'gateway.lock'),
+            sessionArchives: atHome('state', 'runs', 'session-archives'),
+            episodes: atHome('state', 'episodes'),
+            reviewWorkspaceSupport: atHome('state', 'review-workspace-support'),
+            browserCache: atHome('state', 'browser-cache'),
+            copilotRuntime: atHome('state', 'copilot-runtime'),
+            assessmentArtifacts: atHome('state', 'assessment-artifacts'),
+            pressureHistory: atHome('state', 'pressure-history.json'),
+            intelligenceAudit: atHome('state', 'logs', 'intelligence-actions'),
+            feedbackLedger: atHome('state', 'feedback-ledger.json'),
+            extraLogDirs: [],
+        };
+        return options.role === 'gateway'
+            ? {
+                ...shared,
+                role: 'gateway',
+                state: {
+                    ...state,
+                    backlog: atHome('state', 'backlog'),
+                    backlogFile: atHome('state', 'backlog', 'backlog.json'),
+                    roadmap: atHome('state', 'roadmap'),
+                    workGraphs: atHome('state', 'work-graphs'),
+                    copilot: atHome('state', 'copilot'),
+                    assessments: atHome('state', 'assessments'),
+                    analytics: atHome('state', 'analytics'),
+                    backlogSpecs: atHome('state', 'backlog', 'specs'),
+                    refinementPrompts: atHome('state', 'roadmap', 'refinement-prompts'),
+                    dispatchQueue: atHome('state', 'dispatch-queue.json'),
+                    statusFile: atHome('state', 'status.json'),
+                    evalCaps: atHome('state', 'eval-suite-caps.json'),
+                    observabilityAgreement: atHome('state', 'observability-agreement'),
+                    backlogRefinementPrompts: atHome('state', 'backlog', 'refinement-prompts'),
+                    resourceWatchState: atHome('state', 'cache', 'resource-watch-state.json'),
+                    capabilityStore: atHome('state', 'runtime-capabilities.json'),
+                },
+            }
+            : { ...shared, role: 'node', state };
+    }
+    // Source and dist have the same depth. No marker scans or workspace-state reads.
+    const checkout = options.checkoutRoot ?? (env.FARMSLOT_ROOT || undefined) ?? defaultCheckoutRoot();
+    const root = path.resolve(checkout);
+    const userHome = options.userHome ?? homedir();
+    const pool = override('FARMSLOT_POOL_DIR', path.join(root, 'pool'));
+    if (env.FARMSLOT_PROJECTS_DIR)
+        envOverrides.push('FARMSLOT_PROJECTS_DIR');
+    const runs = override('FARMSLOT_RUNS_DIR', path.join(root, '.runs'));
+    const native = path.resolve(override('FARMSLOT_NATIVE_STATE_DIR', atHome('native-sessions'), true));
+    const shared = {
+        layout: 'legacy',
+        instance,
+        home,
+        envOverrides,
+        config: home,
+        configFiles: { sources: override('FARMSLOT_SOURCES_CONFIG', atHome('sources.json'), true) },
+        pool: env.FARMSLOT_POOL_DIR ? path.resolve(pool) : pool,
+        projects: env.FARMSLOT_PROJECTS_DIR
+            ? path.resolve(env.FARMSLOT_PROJECTS_DIR)
+            : path.join(root, 'projects'),
+        templateProjects: path.join(root, 'projects'),
+        code: {
+            checkout: root,
+            agentRuntimeScripts: options.agentRuntimeScripts ??
+                path.join(root, installedProtocol()
+                    ? 'node_modules/@farmslot/agent-runtime/scripts'
+                    : 'packages/agent-runtime/scripts'),
+            templateNode: env.FARMSLOT_WORKSPACE
+                ? path.resolve(expandHome(env.FARMSLOT_WORKSPACE))
+                : root,
+            node: env.FARMSLOT_WORKSPACE ? path.resolve(expandHome(env.FARMSLOT_WORKSPACE)) : root,
+            cli: path.join(userHome, '.local', 'share', 'farmslot-cli'),
+            bin: path.join(userHome, '.local', 'bin'),
+            support: path.join(homedir(), 'farmslot-node', 'support'),
+        },
+        backups: path.join(root, '.backups'),
+        data: {
+            root: home,
+            runBundles: options.legacyFacts?.runBundles ??
+                path.join(options.home !== undefined || env.FARMSLOT_HOME || !env.FARMSLOT_RUNS_DIR
+                    ? home
+                    : path.join(runs, 'bundle-home'), 'run-bundles'),
+            runArchive: override('FARMSLOT_RUN_ARCHIVE_ROOT', atHome('run-archive'), true),
+            taskPinsArchive: atHome('task-pins-archive'),
+            canary: override('CANARY_HOME', path.join(homedir(), 'farmslot-canary')),
+            datasets: atHome('datasets'),
+        },
+    };
+    const state = {
+        runs,
+        taskPins: path.resolve(home, 'task-pins'),
+        nativeSessions: native,
+        reviewWorkspaces: path.join(path.dirname(native), 'review-workspaces'),
+        sources: atHome('sources'),
+        nodeLink: atHome('node-link'),
+        logs: env.FARMSLOT_LOG_DIR
+            ? path.resolve(override('FARMSLOT_LOG_DIR', atHome('logs')))
+            : atHome('logs'),
+        tmp: '/tmp/farmslot-prepare',
+        cache: path.join(override('FARMSLOT_DIR', root), '.farm-cache'),
+        gatewayLock: path.resolve(root, '.runs', `gateway-${Number(env.GATEWAY_PORT) || 7777}.pid`),
+        sessionArchives: path.join(runs, 'session-archives'),
+        episodes: path.join(runs, 'episodes'),
+        reviewWorkspaceSupport: path.join(runs, 'review-workspace-support'),
+        browserCache: env.RECIPE_HARNESS_BROWSER_CACHE
+            ? path.resolve(override('RECIPE_HARNESS_BROWSER_CACHE', ''))
+            : path.join(env.XDG_CACHE_HOME || path.join(homedir(), '.cache'), 'farmslot', 'browser-probe.json'),
+        copilotRuntime: atHome('copilot-runtime'),
+        assessmentArtifacts: home,
+        pressureHistory: atHome('state', 'pressure-history.json'),
+        intelligenceAudit: override('FARMSLOT_INTELLIGENCE_AUDIT_DIR', atHome('logs', 'intelligence-actions'), true),
+        feedbackLedger: env.FARMSLOT_FEEDBACK_LEDGER?.trim()
+            ? override('FARMSLOT_FEEDBACK_LEDGER', '').trim()
+            : atHome('state', 'feedback-ledger.json'),
+        extraLogDirs: override('FARMSLOT_EXTRA_LOG_DIRS', '')
+            .split(path.delimiter)
+            .map((entry) => entry.trim())
+            .filter(Boolean)
+            .map((entry) => path.resolve(entry)),
+    };
+    return options.role === 'gateway'
+        ? {
+            ...shared,
+            role: 'gateway',
+            state: {
+                ...state,
+                backlog: override('FARMSLOT_BACKLOG_FILE', path.join(root, '.backlog.json')),
+                backlogFile: env.FARMSLOT_BACKLOG_FILE || path.join(root, '.backlog.json'),
+                roadmap: override('FARMSLOT_ROADMAP_DIR', path.join(root, '.roadmap'), true),
+                workGraphs: override('FARMSLOT_WORK_GRAPH_DIR', path.join(root, '.work-graphs')),
+                copilot: override('FARMSLOT_COPILOT_DIR', path.join(root, 'copilot'), true),
+                assessments: atHome('assessments'),
+                analytics: override('FARMSLOT_ANALYTICS_DIR', path.join(root, '.runs', 'analytics')),
+                backlogSpecs: override('FARMSLOT_BACKLOG_SPEC_DIR', path.join(root, '.backlog', 'specs'), true),
+                refinementPrompts: override('FARMSLOT_ROADMAP_REFINEMENT_PROMPT_DIR', path.join(env.FARMSLOT_ROADMAP_DIR ?? path.join(root, '.roadmap'), 'refinement-prompts'), true),
+                dispatchQueue: override('FARMSLOT_DISPATCH_QUEUE_FILE', path.join(root, '.dispatch-queue.json')),
+                statusFile: path.join(root, '.farm-status.json'),
+                evalCaps: override('FARMSLOT_EVAL_SUITE_CAP_FILE', path.join(root, '.eval-suite-caps.json')),
+                observabilityAgreement: override('FARMSLOT_OBSERVABILITY_AGREEMENT_DIR', path.join(root, '.runs', 'observability-agreement')),
+                backlogRefinementPrompts: override('FARMSLOT_BACKLOG_REFINEMENT_PROMPT_DIR', path.join(root, '.backlog', 'refinement-prompts'), true),
+                resourceWatchState: override('FARMSLOT_RESOURCE_WATCH_STATE_FILE', path.join(root, '.farm-cache', 'resource-watch-state.json'), true),
+                capabilityStore: override('FARMSLOT_CAPABILITY_STORE_FILE', path.join(env.FARMSLOT_ROOT?.trim() || process.cwd(), '.runs', `runtime-capabilities-${env.GATEWAY_PORT?.trim() || '7777'}.json`)),
+            },
+        }
+        : { ...shared, role: 'node', state };
+}
+// A process may switch homes during a test or CLI invocation. Include the marker timestamp
+// and environment in the key so neither a migration nor a changed override leaves stale roots.
+const processPaths = new Map();
+const warnedOverrides = new Set();
+export function currentFarmPaths(role, env = process.env, checkoutRoot) {
+    const home = expandHome(env.FARMSLOT_HOME?.trim() || path.join(homedir(), '.farmslot'));
+    let marker = 'absent';
+    try {
+        const info = statSync(path.join(home, 'config', 'instance.json'));
+        marker = `${info.mtimeMs}:${info.ctimeMs}:${info.size}`;
+    }
+    catch (error) {
+        // A missing marker selects legacy; permission and other filesystem errors must surface.
+        if (!(error instanceof Error && 'code' in error && error.code === 'ENOENT'))
+            throw error;
+    }
+    const selectedEnv = Object.entries(env).filter(([name]) => name.startsWith('FARMSLOT_') ||
+        name === 'GATEWAY_PORT' ||
+        name === 'CANARY_HOME' ||
+        name === 'RECIPE_HARNESS_BROWSER_CACHE' ||
+        name === 'XDG_CACHE_HOME');
+    const key = JSON.stringify([
+        role,
+        home,
+        homedir(),
+        marker,
+        checkoutRoot,
+        process.cwd(),
+        selectedEnv,
+    ]);
+    let paths = processPaths.get(key);
+    if (!paths) {
+        paths = resolveFarmPaths({ role, env, checkoutRoot });
+        processPaths.set(key, paths);
+    }
+    for (const name of paths.envOverrides) {
+        if (warnedOverrides.has(name))
+            continue;
+        warnedOverrides.add(name);
+        console.warn(`[farm-paths] ${name} is deprecated; configure instance.json before migrating to layout 2`);
+    }
+    return paths;
+}
+/** Older nodes have no report. Keep their shell-expanded legacy paths in one place.
+ * Template expansion historically honors WORKSPACE; helper execution does not.
+ */
+export function legacyRemoteFarmPaths(env = {}, discoveredCheckout, agentRuntimeScripts) {
+    const node = discoveredCheckout ?? path.posix.join(env.HOME?.trim() || '~', 'farmslot-node');
+    return {
+        home: env.FARMSLOT_HOME?.trim() || '~/.farmslot',
+        pool: env.FARMSLOT_POOL_DIR || path.posix.join(node, 'pool'),
+        projects: env.FARMSLOT_PROJECTS_DIR || path.posix.join(node, 'projects'),
+        code: {
+            checkout: node,
+            agentRuntimeScripts: agentRuntimeScripts ??
+                path.posix.join(node, 'node_modules/@farmslot/agent-runtime/scripts'),
+            node,
+            templateNode: env.FARMSLOT_WORKSPACE?.trim() || node,
+            cli: '~/.local/share/farmslot-cli',
+            bin: '~/.local/bin',
+            // Remote bundles are deployed beside the selected node checkout; the local
+            // legacy selector uses the user-home node install even from an operator checkout.
+            support: path.posix.join(node, 'support'),
+        },
+        state: {
+            runs: env.FARMSLOT_RUNS_DIR || path.posix.join(node, '.runs'),
+            tmp: '/tmp/farmslot-prepare',
+        },
+    };
+}
+/** Validate the optional wire report without trusting a cast at the RPC boundary. */
+export function isNodeFarmPaths(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const fields = Object.fromEntries(Object.entries(value));
+    const stringFields = (item, names) => {
+        if (!item || typeof item !== 'object' || Array.isArray(item))
+            return false;
+        return names.every((name) => {
+            const field = Reflect.get(item, name);
+            return typeof field === 'string' && !field.includes('\0');
+        });
+    };
+    const strings = (item) => Array.isArray(item) && item.every((entry) => typeof entry === 'string');
+    return (fields.role === 'node' &&
+        (fields.layout === 'legacy' || fields.layout === 2) &&
+        stringFields(value, [
+            'instance',
+            'home',
+            'config',
+            'pool',
+            'projects',
+            'templateProjects',
+            'backups',
+        ]) &&
+        stringFields(fields.configFiles, ['sources']) &&
+        stringFields(fields.code, [
+            'checkout',
+            'agentRuntimeScripts',
+            'templateNode',
+            'node',
+            'cli',
+            'bin',
+            'support',
+        ]) &&
+        stringFields(fields.data, [
+            'root',
+            'runBundles',
+            'runArchive',
+            'taskPinsArchive',
+            'canary',
+            'datasets',
+        ]) &&
+        stringFields(fields.state, [
+            'runs',
+            'taskPins',
+            'nativeSessions',
+            'reviewWorkspaces',
+            'sources',
+            'nodeLink',
+            'logs',
+            'tmp',
+            'cache',
+            'gatewayLock',
+            'sessionArchives',
+            'episodes',
+            'reviewWorkspaceSupport',
+            'browserCache',
+            'copilotRuntime',
+            'assessmentArtifacts',
+            'pressureHistory',
+            'intelligenceAudit',
+            'feedbackLedger',
+        ]) &&
+        strings(fields.envOverrides) &&
+        fields.state !== null &&
+        typeof fields.state === 'object' &&
+        strings(Reflect.get(fields.state, 'extraLogDirs')));
+}
+// A standalone service installs the protocol as a scoped dependency. Its package
+// location tells us the installation root without reading a second marker or package.
+function installedProtocol() {
+    const packageRoot = path.resolve(fileURLToPath(new URL('../../', import.meta.url)));
+    return (path.basename(path.dirname(packageRoot)) === '@farmslot' &&
+        path.basename(path.dirname(path.dirname(packageRoot))) === 'node_modules');
+}
+function defaultCheckoutRoot() {
+    return fileURLToPath(new URL(installedProtocol() ? '../../../../../' : '../../../../', import.meta.url));
+}
+//# sourceMappingURL=farm-paths.js.map