@elaraai/e3-rack 0.0.0-bootstrap.0 → 1.0.94

package/dist/src/routing/eligibility.js

@@ -0,0 +1,78 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { decodeTaskObject } from '@elaraai/e3-types';
+import { selectTask } from './policy.js';
+import { rackTierFor } from './tiers.js';
+import { scanProgram } from './host-coupling.js';
+/**
+ * Evaluates routing once per logical task and graph name for a run.
+ * The program and output reducer are task-object references, so a merge that
+ * arrives before any map (cached maps) receives the same complete scan.
+ * @example
+ * const eligibility = await new EligibilityEvaluator(policy).evaluate(request);
+ */
+export class EligibilityEvaluator {
+    policy;
+    verdicts = new Map();
+    /** @param policy - The policy snapshot for this run */
+    constructor(policy) {
+        this.policy = policy;
+    }
+    /**
+     * Checks selection, runtime, environment and every executable IR bundle.
+     * @param request - A task or split unit after its cache miss
+     * @returns Its eligibility, with a deterministic reason on refusal
+     */
+    evaluate(request) {
+        const name = request.options.taskName;
+        if (name === undefined)
+            return Promise.resolve({ eligible: false, reason: 'no-task-name' });
+        const hash = request.logicalTaskHash ?? request.taskHash;
+        const key = JSON.stringify([request.repo, hash, name]);
+        let result = this.verdicts.get(key);
+        if (result === undefined) {
+            if (this.verdicts.size >= 4096)
+                this.verdicts.clear();
+            result = this.check(request, hash, name);
+            this.verdicts.set(key, result);
+        }
+        return result;
+    }
+    async check(request, logicalHash, name) {
+        const selection = selectTask(this.policy, name);
+        if (selection.target === 'local')
+            return { eligible: false, reason: 'not-selected' };
+        try {
+            const task = logicalHash === request.taskHash ? request.task : decodeTaskObject(await request.storage.objects.read(request.repo, logicalHash));
+            if (task.environment.type === 'some')
+                return { eligible: false, reason: 'environment' };
+            const tier = rackTierFor(task.runner);
+            if ('ineligible' in tier)
+                return { eligible: false, reason: tier.ineligible };
+            if (task.body.type !== 'east')
+                return { eligible: false, reason: 'custom-runner' };
+            if (!selection.allowHostCoupled) {
+                const programs = [task.body.value.program];
+                const output = task.output.kind;
+                if (output.type === 'dict' && output.value.merge.type === 'some')
+                    programs.push(output.value.merge.value);
+                if (output.type === 'fold')
+                    programs.push(output.value.combine);
+                const blocked = new Set();
+                for (const hash of programs) {
+                    for (const platform of await scanProgram(hash, () => request.storage.objects.read(request.repo, hash)))
+                        blocked.add(platform);
+                }
+                if (blocked.size > 0)
+                    return { eligible: false, reason: `host-coupled:${[...blocked].sort().join(',')}` };
+            }
+            return { eligible: true, tier: tier.tier, size: selection.size, timeoutMinutes: selection.timeoutMinutes };
+        }
+        catch {
+            return { eligible: false, reason: 'unscannable' };
+        }
+    }
+}
+//# sourceMappingURL=eligibility.js.map

package/dist/src/routing/eligibility.js.map

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

package/dist/src/routing/host-coupling.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/** Platform families that depend on host state or network access. */
+export declare const HOST_COUPLED_PREFIXES: readonly ["fs_", "env_", "sqlite_", "access_", "fetch_", "s3_", "postgres_", "mysql_", "redis_", "mongodb_", "ftp_", "sftp_"];
+/**
+ * Collects every called platform name, including nested functions/dead branches.
+ * @param bytes - A sync or async East IR envelope
+ * @returns Sorted, distinct platform names
+ * @throws When neither envelope decodes
+ * @example
+ * const platforms = collectPlatformNames(await storage.objects.read(repo, program));
+ */
+export declare function collectPlatformNames(bytes: Uint8Array): string[];
+/**
+ * Selects platform calls whose host dependencies are unavailable in a guest.
+ * @param names - The program's platform names
+ * @returns Blocked names in input order
+ * @example
+ * hostCoupledPlatforms(['console_log', 'env_get']); // ['env_get']
+ */
+export declare function hostCoupledPlatforms(names: Iterable<string>): string[];
+/** Reads and scans an immutable IR object once per process, bounded to 4096. @internal */
+export declare function scanProgram(hash: string, read: () => Promise<Uint8Array>): Promise<readonly string[]>;
+//# sourceMappingURL=host-coupling.d.ts.map

package/dist/src/routing/host-coupling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-coupling.d.ts","sourceRoot":"","sources":["../../../src/routing/host-coupling.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,+HAOxB,CAAC;AAKX;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CAOhE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAEtE;AAID,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CASrG"}

package/dist/src/routing/host-coupling.js

@@ -0,0 +1,62 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { decodeAsyncEastIR, decodeEastIR, walkIR } from '@elaraai/east';
+/** Platform families that depend on host state or network access. */
+export const HOST_COUPLED_PREFIXES = [
+    'fs_', // Host files and directories.
+    'env_', // Host environment variables and process state.
+    'sqlite_', 'access_', // Local database files.
+    'fetch_', 's3_', // HTTP and object storage.
+    'postgres_', 'mysql_', 'redis_', 'mongodb_', // Network database services.
+    'ftp_', 'sftp_', // Remote files.
+];
+// These are exact names: json_open_text reads an argument, not a host file.
+const HOST_COUPLED_NAMES = new Set(['json_open', 'json_value', 'path_resolve']);
+/**
+ * Collects every called platform name, including nested functions/dead branches.
+ * @param bytes - A sync or async East IR envelope
+ * @returns Sorted, distinct platform names
+ * @throws When neither envelope decodes
+ * @example
+ * const platforms = collectPlatformNames(await storage.objects.read(repo, program));
+ */
+export function collectPlatformNames(bytes) {
+    let ir;
+    try {
+        ir = decodeAsyncEastIR(bytes).ir;
+    }
+    catch {
+        ir = decodeEastIR(bytes).ir;
+    }
+    const names = new Set();
+    walkIR(ir, (node) => { if (node.type === 'Platform')
+        names.add(node.value.name); });
+    return [...names].sort();
+}
+/**
+ * Selects platform calls whose host dependencies are unavailable in a guest.
+ * @param names - The program's platform names
+ * @returns Blocked names in input order
+ * @example
+ * hostCoupledPlatforms(['console_log', 'env_get']); // ['env_get']
+ */
+export function hostCoupledPlatforms(names) {
+    return [...names].filter((name) => HOST_COUPLED_NAMES.has(name) || HOST_COUPLED_PREFIXES.some((prefix) => name.startsWith(prefix)));
+}
+const scans = new Map();
+/** Reads and scans an immutable IR object once per process, bounded to 4096. @internal */
+export function scanProgram(hash, read) {
+    let result = scans.get(hash);
+    if (result === undefined) {
+        if (scans.size >= 4096)
+            scans.clear();
+        result = read().then((bytes) => hostCoupledPlatforms(collectPlatformNames(bytes)));
+        scans.set(hash, result);
+        void result.catch(() => { if (scans.get(hash) === result)
+            scans.delete(hash); });
+    }
+    return result;
+}
+//# sourceMappingURL=host-coupling.js.map

package/dist/src/routing/host-coupling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-coupling.js","sourceRoot":"","sources":["../../../src/routing/host-coupling.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,EAAW,MAAM,eAAe,CAAC;AAEjF,qEAAqE;AACrE,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,KAAK,EAAE,8BAA8B;IACrC,MAAM,EAAE,gDAAgD;IACxD,SAAS,EAAE,SAAS,EAAE,wBAAwB;IAC9C,QAAQ,EAAE,KAAK,EAAE,2BAA2B;IAC5C,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,6BAA6B;IAC1E,MAAM,EAAE,OAAO,EAAE,gBAAgB;CACzB,CAAC;AAEX,4EAA4E;AAC5E,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC;AAEhF;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAiB;IACpD,IAAI,EAAM,CAAC;IACX,IAAI,CAAC;QAAC,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAmB,CAAC;IAAC,CAAC;IAC1D,MAAM,CAAC;QAAC,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAmB,CAAC;IAAC,CAAC;IACvD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;QAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpF,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAuB;IAC1D,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACtI,CAAC;AAED,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsC,CAAC;AAE5D,0FAA0F;AAC1F,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAA+B;IACvE,IAAI,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI;YAAE,KAAK,CAAC,KAAK,EAAE,CAAC;QACtC,MAAM,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnF,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxB,KAAK,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,MAAM;YAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/routing/policy.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { ArrayType, BooleanType, IntegerType, NullType, OptionType, StringType, StructType, VariantType, type ValueTypeOf } from '@elaraai/east';
+/** The VM shapes the rack agent supports. */
+export declare const RackComputeSizeType: VariantType<{
+    readonly serverless: NullType;
+    readonly small: NullType;
+    readonly medium: NullType;
+    readonly large: NullType;
+    readonly xlarge: NullType;
+}>;
+/** A whole-task-name glob and its execution policy; first match wins. */
+export declare const RackRuleType: StructType<{
+    readonly tasks: StringType;
+    readonly target: VariantType<{
+        readonly rack: NullType;
+        readonly local: NullType;
+    }>;
+    readonly size: OptionType<VariantType<{
+        readonly serverless: NullType;
+        readonly small: NullType;
+        readonly medium: NullType;
+        readonly large: NullType;
+        readonly xlarge: NullType;
+    }>>;
+    readonly timeoutMinutes: OptionType<IntegerType>;
+    readonly allowHostCoupled: BooleanType;
+}>;
+/**
+ * Stores this repository's rack opt-in. Runtime policy never affects hashes.
+ * This is repository state: a future shape change needs a repository upgrade
+ * under WIRE_MIGRATION.md, not a fallback decoder or an in-place widening.
+ */
+export declare const RackPolicyType: StructType<{
+    readonly enabled: BooleanType;
+    readonly mode: VariantType<{
+        readonly optIn: NullType;
+        readonly auto: NullType;
+    }>;
+    readonly rules: ArrayType<StructType<{
+        readonly tasks: StringType;
+        readonly target: VariantType<{
+            readonly rack: NullType;
+            readonly local: NullType;
+        }>;
+        readonly size: OptionType<VariantType<{
+            readonly serverless: NullType;
+            readonly small: NullType;
+            readonly medium: NullType;
+            readonly large: NullType;
+            readonly xlarge: NullType;
+        }>>;
+        readonly timeoutMinutes: OptionType<IntegerType>;
+        readonly allowHostCoupled: BooleanType;
+    }>>;
+    readonly defaultSize: VariantType<{
+        readonly serverless: NullType;
+        readonly small: NullType;
+        readonly medium: NullType;
+        readonly large: NullType;
+        readonly xlarge: NullType;
+    }>;
+    readonly defaultTimeoutMinutes: IntegerType;
+    readonly spill: BooleanType;
+    readonly claimTimeoutSeconds: IntegerType;
+    readonly retryTaskFailuresLocally: BooleanType;
+}>;
+/** A repository's rack policy. */
+export type RackPolicy = ValueTypeOf<typeof RackPolicyType>;
+/** A task's rule. */
+export type RackRule = ValueTypeOf<typeof RackRuleType>;
+/** An agent VM shape. */
+export type RackComputeSize = ValueTypeOf<typeof RackComputeSizeType>['type'];
+/** Conservative defaults: disabled, with explicit task selection required. */
+export declare const DEFAULT_RACK_POLICY: RackPolicy;
+/** Explains a policy that cannot be used; no damaged policy silently delegates. */
+export declare class RackPolicyError extends Error {
+    /** @param message - The invalid policy and its remedy */
+    constructor(message: string);
+}
+/**
+ * Names a repository's runtime rack policy.
+ * @param repo - Repository path
+ * @returns Its policy path
+ * @example
+ * const path = policyPath(repo);
+ */
+export declare function policyPath(repo: string): string;
+/**
+ * Reads the policy, or returns independent defaults when none exists.
+ * @param repo - Repository path
+ * @returns The policy
+ * @throws {RackPolicyError} When the file is invalid, naming its reset command
+ * @example
+ * const policy = await loadPolicy(repo);
+ */
+export declare function loadPolicy(repo: string): Promise<RackPolicy>;
+/**
+ * Atomically persists a validated rack policy.
+ * @param repo - Repository path
+ * @param policy - The new policy
+ * @returns Once durable to concurrent readers
+ * @example
+ * await savePolicy(repo, setEnabled(await loadPolicy(repo), true));
+ */
+export declare function savePolicy(repo: string, policy: RackPolicy): Promise<void>;
+/** A task's selected runtime policy, with the winning rule's index. */
+export interface TaskSelection {
+    /** Where this task is requested to run. */
+    target: 'rack' | 'local';
+    /** Rack VM shape. */
+    size: RackComputeSize;
+    /** Maximum execution time in minutes. */
+    timeoutMinutes: number;
+    /** Whether the author deliberately overrides the host-access guard. */
+    allowHostCoupled: boolean;
+    /** First matching rule, or null for policy defaults. */
+    ruleIndex: number | null;
+}
+/**
+ * Selects the first whole-name matching rule, then policy defaults.
+ * @param policy - The run's policy
+ * @param taskName - The graph task name
+ * @returns Its selection (eligibility is checked separately)
+ * @example
+ * const selection = selectTask(policy, 'train_model');
+ */
+export declare function selectTask(policy: RackPolicy, taskName: string): TaskSelection;
+/** Optional settings applied when replacing or adding a task rule. */
+export interface RuleSettings {
+    /** Rack VM shape. */
+    size?: RackComputeSize;
+    /** Maximum task time in minutes. */
+    timeoutMinutes?: number;
+    /** Deliberate override of the host-access guard. */
+    allowHostCoupled?: boolean;
+}
+/**
+ * Replaces a rule in place, or appends it, leaving its input policy unchanged.
+ * @param policy - Original policy
+ * @param tasks - Whole-name glob
+ * @param target - Requested location
+ * @param settings - Optional overrides
+ * @returns An independent policy
+ * @example
+ * const next = setRule(policy, 'train_*', 'rack', { size: 'large' });
+ */
+export declare function setRule(policy: RackPolicy, tasks: string, target: 'rack' | 'local', settings?: RuleSettings): RackPolicy;
+/**
+ * Removes an exact pattern without changing the input policy.
+ * @param policy - Original policy
+ * @param tasks - Pattern to remove
+ * @returns An independent policy
+ * @example
+ * const next = removeRule(policy, 'train_*');
+ */
+export declare function removeRule(policy: RackPolicy, tasks: string): RackPolicy;
+/**
+ * Changes whether rack routing is enabled by default.
+ * @param policy - Original policy
+ * @param enabled - New default
+ * @returns An independent policy
+ * @example
+ * const next = setEnabled(policy, true);
+ */
+export declare function setEnabled(policy: RackPolicy, enabled: boolean): RackPolicy;
+/**
+ * Changes the unmatched-task selection mode.
+ * @param policy - Original policy
+ * @param mode - optIn or auto
+ * @returns An independent policy
+ * @example
+ * const next = setMode(policy, 'auto');
+ */
+export declare function setMode(policy: RackPolicy, mode: 'optIn' | 'auto'): RackPolicy;
+/**
+ * Whether the policy can select any task for a rack: automatic selection of
+ * unmatched tasks, or a rule whose target is a rack. A run under a policy
+ * that cannot opens no rack session, and waits for no rack.
+ * @param policy - The run's policy
+ * @returns Whether a task could be routed to a rack
+ * @example
+ * if (policyTargetsRack(policy)) rack = await openRackRunner(options);
+ */
+export declare function policyTargetsRack(policy: RackPolicy): boolean;
+//# sourceMappingURL=policy.d.ts.map

package/dist/src/routing/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../src/routing/policy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAyD,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAGxM,6CAA6C;AAC7C,eAAO,MAAM,mBAAmB;;;;;;EAA8G,CAAC;AAC/I,yEAAyE;AACzE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;EAMvB,CAAC;AACH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASzB,CAAC;AACH,kCAAkC;AAClC,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,cAAc,CAAC,CAAC;AAC5D,qBAAqB;AACrB,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,YAAY,CAAC,CAAC;AACxD,yBAAyB;AACzB,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,EAAE,UAGjC,CAAC;AAIF,mFAAmF;AACnF,qBAAa,eAAgB,SAAQ,KAAK;IACxC,yDAAyD;gBAC7C,OAAO,EAAE,MAAM;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAgD;AAoBhG;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAclE;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhF;AAaD,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,qBAAqB;IACrB,IAAI,EAAE,eAAe,CAAC;IACtB,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wDAAwD;IACxD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAU9E;AAED,sEAAsE;AACtE,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,QAAQ,GAAE,YAAiB,GAAG,UAAU,CAW5H;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAExE;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,CAAmD;AAE/H;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,CAAqE;AAEpJ;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAE7D"}

package/dist/src/routing/policy.js

@@ -0,0 +1,212 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { ArrayType, BooleanType, IntegerType, NullType, OptionType, StringType, StructType, VariantType, decodeBeast2For, encodeBeast2For, none, some, variant } from '@elaraai/east';
+import { atomicWriteFile } from '@elaraai/e3-core';
+/** The VM shapes the rack agent supports. */
+export const RackComputeSizeType = VariantType({ serverless: NullType, small: NullType, medium: NullType, large: NullType, xlarge: NullType });
+/** A whole-task-name glob and its execution policy; first match wins. */
+export const RackRuleType = StructType({
+    tasks: StringType,
+    target: VariantType({ rack: NullType, local: NullType }),
+    size: OptionType(RackComputeSizeType),
+    timeoutMinutes: OptionType(IntegerType),
+    allowHostCoupled: BooleanType,
+});
+/**
+ * Stores this repository's rack opt-in. Runtime policy never affects hashes.
+ * This is repository state: a future shape change needs a repository upgrade
+ * under WIRE_MIGRATION.md, not a fallback decoder or an in-place widening.
+ */
+export const RackPolicyType = StructType({
+    enabled: BooleanType,
+    mode: VariantType({ optIn: NullType, auto: NullType }),
+    rules: ArrayType(RackRuleType),
+    defaultSize: RackComputeSizeType,
+    defaultTimeoutMinutes: IntegerType,
+    spill: BooleanType,
+    claimTimeoutSeconds: IntegerType,
+    retryTaskFailuresLocally: BooleanType,
+});
+/** Conservative defaults: disabled, with explicit task selection required. */
+export const DEFAULT_RACK_POLICY = {
+    enabled: false, mode: variant('optIn', null), rules: [], defaultSize: variant('large', null),
+    defaultTimeoutMinutes: 1440n, spill: true, claimTimeoutSeconds: 30n, retryTaskFailuresLocally: false,
+};
+const encode = encodeBeast2For(RackPolicyType);
+const decode = decodeBeast2For(RackPolicyType);
+/** Explains a policy that cannot be used; no damaged policy silently delegates. */
+export class RackPolicyError extends Error {
+    /** @param message - The invalid policy and its remedy */
+    constructor(message) { super(message); this.name = 'RackPolicyError'; }
+}
+/**
+ * Names a repository's runtime rack policy.
+ * @param repo - Repository path
+ * @returns Its policy path
+ * @example
+ * const path = policyPath(repo);
+ */
+export function policyPath(repo) { return join(repo, 'rack', 'policy.beast2'); }
+function positive(value, field) {
+    if (!Number.isSafeInteger(Number(value)) || Number(value) <= 0)
+        throw new RackPolicyError(`${field} must be a positive safe integer`);
+}
+function validate(policy) {
+    positive(policy.defaultTimeoutMinutes, 'defaultTimeoutMinutes');
+    positive(policy.claimTimeoutSeconds, 'claimTimeoutSeconds');
+    if (Number(policy.claimTimeoutSeconds) > Number.MAX_SAFE_INTEGER / 1000)
+        throw new RackPolicyError('claimTimeoutSeconds is too large');
+    if (Number(policy.defaultTimeoutMinutes) > Number.MAX_SAFE_INTEGER / 60_000)
+        throw new RackPolicyError('defaultTimeoutMinutes is too large');
+    for (const rule of policy.rules) {
+        if (rule.tasks.length === 0)
+            throw new RackPolicyError('A task pattern cannot be empty');
+        if (rule.timeoutMinutes.type === 'some') {
+            positive(rule.timeoutMinutes.value, 'timeoutMinutes');
+            if (Number(rule.timeoutMinutes.value) > Number.MAX_SAFE_INTEGER / 60_000)
+                throw new RackPolicyError('timeoutMinutes is too large');
+        }
+    }
+}
+/**
+ * Reads the policy, or returns independent defaults when none exists.
+ * @param repo - Repository path
+ * @returns The policy
+ * @throws {RackPolicyError} When the file is invalid, naming its reset command
+ * @example
+ * const policy = await loadPolicy(repo);
+ */
+export async function loadPolicy(repo) {
+    const file = policyPath(repo);
+    let bytes;
+    try {
+        bytes = await readFile(file);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return decode(encode(DEFAULT_RACK_POLICY));
+        throw err;
+    }
+    try {
+        const policy = decode(bytes);
+        validate(policy);
+        return policy;
+    }
+    catch (err) {
+        throw new RackPolicyError(`${file}: ${err instanceof Error ? err.message : String(err)}; use 'e3 rack policy reset' to restore defaults`);
+    }
+}
+/**
+ * Atomically persists a validated rack policy.
+ * @param repo - Repository path
+ * @param policy - The new policy
+ * @returns Once durable to concurrent readers
+ * @example
+ * await savePolicy(repo, setEnabled(await loadPolicy(repo), true));
+ */
+export async function savePolicy(repo, policy) {
+    validate(policy);
+    await atomicWriteFile(policyPath(repo), encode(policy));
+}
+const patterns = new Map();
+function pattern(text) {
+    let result = patterns.get(text);
+    if (result === undefined) {
+        result = new RegExp(`^${[...text].map((c) => c === '*' ? '.*' : c === '?' ? '.' : c.replace(/[\\^$.*+?()[\]{}|]/g, '\\$&')).join('')}$`, 'u');
+        if (patterns.size >= 4096)
+            patterns.clear();
+        patterns.set(text, result);
+    }
+    return result;
+}
+/**
+ * Selects the first whole-name matching rule, then policy defaults.
+ * @param policy - The run's policy
+ * @param taskName - The graph task name
+ * @returns Its selection (eligibility is checked separately)
+ * @example
+ * const selection = selectTask(policy, 'train_model');
+ */
+export function selectTask(policy, taskName) {
+    const index = policy.rules.findIndex((rule) => pattern(rule.tasks).test(taskName));
+    const rule = policy.rules[index];
+    return {
+        target: rule?.target.type ?? (policy.mode.type === 'auto' ? 'rack' : 'local'),
+        size: rule?.size.type === 'some' ? rule.size.value.type : policy.defaultSize.type,
+        timeoutMinutes: Number(rule?.timeoutMinutes.type === 'some' ? rule.timeoutMinutes.value : policy.defaultTimeoutMinutes),
+        allowHostCoupled: rule?.allowHostCoupled ?? false,
+        ruleIndex: index < 0 ? null : index,
+    };
+}
+/**
+ * Replaces a rule in place, or appends it, leaving its input policy unchanged.
+ * @param policy - Original policy
+ * @param tasks - Whole-name glob
+ * @param target - Requested location
+ * @param settings - Optional overrides
+ * @returns An independent policy
+ * @example
+ * const next = setRule(policy, 'train_*', 'rack', { size: 'large' });
+ */
+export function setRule(policy, tasks, target, settings = {}) {
+    const next = decode(encode(policy));
+    if (settings.timeoutMinutes !== undefined && (!Number.isSafeInteger(settings.timeoutMinutes) || settings.timeoutMinutes <= 0)) {
+        throw new RackPolicyError('timeoutMinutes must be a positive safe integer');
+    }
+    const rule = { tasks, target: variant(target, null), size: settings.size === undefined ? none : some(variant(settings.size, null)),
+        timeoutMinutes: settings.timeoutMinutes === undefined ? none : some(BigInt(settings.timeoutMinutes)), allowHostCoupled: settings.allowHostCoupled ?? false };
+    const index = next.rules.findIndex((r) => r.tasks === tasks);
+    if (index < 0)
+        next.rules.push(rule);
+    else
+        next.rules[index] = rule;
+    validate(next);
+    return next;
+}
+/**
+ * Removes an exact pattern without changing the input policy.
+ * @param policy - Original policy
+ * @param tasks - Pattern to remove
+ * @returns An independent policy
+ * @example
+ * const next = removeRule(policy, 'train_*');
+ */
+export function removeRule(policy, tasks) {
+    const next = decode(encode(policy));
+    return { ...next, rules: next.rules.filter((r) => r.tasks !== tasks) };
+}
+/**
+ * Changes whether rack routing is enabled by default.
+ * @param policy - Original policy
+ * @param enabled - New default
+ * @returns An independent policy
+ * @example
+ * const next = setEnabled(policy, true);
+ */
+export function setEnabled(policy, enabled) { return { ...decode(encode(policy)), enabled }; }
+/**
+ * Changes the unmatched-task selection mode.
+ * @param policy - Original policy
+ * @param mode - optIn or auto
+ * @returns An independent policy
+ * @example
+ * const next = setMode(policy, 'auto');
+ */
+export function setMode(policy, mode) { return { ...decode(encode(policy)), mode: variant(mode, null) }; }
+/**
+ * Whether the policy can select any task for a rack: automatic selection of
+ * unmatched tasks, or a rule whose target is a rack. A run under a policy
+ * that cannot opens no rack session, and waits for no rack.
+ * @param policy - The run's policy
+ * @returns Whether a task could be routed to a rack
+ * @example
+ * if (policyTargetsRack(policy)) rack = await openRackRunner(options);
+ */
+export function policyTargetsRack(policy) {
+    return policy.mode.type === 'auto' || policy.rules.some((rule) => rule.target.type === 'rack');
+}
+//# sourceMappingURL=policy.js.map

package/dist/src/routing/policy.js.map

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

package/dist/src/routing/routing.spec.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+export {};
+//# sourceMappingURL=routing.spec.d.ts.map

package/dist/src/routing/routing.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.spec.d.ts","sourceRoot":"","sources":["../../../src/routing/routing.spec.ts"],"names":[],"mappings":"AAAA;;;GAGG"}