@senpi/runtime 1.0.95-dev.20260408174401

package/dist/runtime/scanner-composition.js

@@ -0,0 +1,168 @@
+import { isConsumedArtifactBinding } from "../scanners/input-descriptors.js";
+export function buildScannerComposition(config, definitions, logger) {
+    const nodes = new Map();
+    const producedContextByScanner = new Map();
+    for (const definition of definitions) {
+        const producedContracts = definition.artifacts?.produces ?? [];
+        const outputs = resolveScannerOutputs(definition, logger);
+        validateScannerOutputs(definition.id, outputs, producedContracts);
+        const producedContext = producedContracts[0] ?? null;
+        const node = {
+            id: definition.id,
+            outputs,
+            dependsOn: definition.dependsOn ?? [],
+            producedContext,
+        };
+        nodes.set(definition.id, node);
+        if (producedContext) {
+            producedContextByScanner.set(definition.id, producedContext);
+        }
+    }
+    const dependencyGraph = new Map();
+    const dependencySources = new Set();
+    for (const definition of definitions) {
+        const dependencies = definition.dependsOn ?? [];
+        validateScannerDependencies(definition, dependencies, nodes, producedContextByScanner);
+        dependencyGraph.set(definition.id, dependencies.map((dependency) => dependency.scanner));
+        for (const dependency of dependencies) {
+            dependencySources.add(dependency.scanner);
+        }
+        validateRequiredBindings(definition, dependencies, producedContextByScanner);
+    }
+    validateActionReferences(config, nodes);
+    const topologicalOrder = topologicallySort(nodes, dependencyGraph);
+    return {
+        scanners: nodes,
+        dependencyGraph,
+        dependencySources,
+        topologicalOrder,
+        producedContextByScanner,
+        getRunChain(scannerId) {
+            if (!nodes.has(scannerId)) {
+                throw new Error(`Scanner '${scannerId}' is not part of the configured composition.`);
+            }
+            const visited = new Set();
+            const order = [];
+            const visit = (id) => {
+                if (visited.has(id)) {
+                    return;
+                }
+                visited.add(id);
+                for (const dependency of dependencyGraph.get(id) ?? []) {
+                    visit(dependency);
+                }
+                order.push(id);
+            };
+            visit(scannerId);
+            return order;
+        },
+    };
+}
+function resolveScannerOutputs(definition, logger) {
+    const inferredContext = (definition.artifacts?.produces?.length ?? 0) > 0;
+    if (!definition.outputs) {
+        logger?.warn?.("Scanner is relying on inferred outputs metadata. Declare definition.outputs explicitly.", {
+            scannerId: definition.id,
+            inferredSignals: true,
+            inferredContext,
+        });
+    }
+    return {
+        signals: definition.outputs?.signals ?? true,
+        context: definition.outputs?.context ?? inferredContext,
+    };
+}
+function validateScannerOutputs(scannerId, outputs, producedContracts) {
+    if (outputs.context) {
+        if (producedContracts.length !== 1) {
+            throw new Error(`Scanner '${scannerId}' declares outputs.context=true but must produce exactly one context contract in v1.`);
+        }
+    }
+    else if (producedContracts.length > 0) {
+        throw new Error(`Scanner '${scannerId}' declares outputs.context=false but still produces shared context contracts.`);
+    }
+}
+function validateScannerDependencies(definition, dependencies, nodes, producedContextByScanner) {
+    for (const dependency of dependencies) {
+        const source = nodes.get(dependency.scanner);
+        if (!source) {
+            throw new Error(`Scanner '${definition.id}' depends on unknown scanner '${dependency.scanner}'.`);
+        }
+        if (!source.outputs.context) {
+            throw new Error(`Scanner '${definition.id}' depends on '${dependency.scanner}', but that scanner does not produce context.`);
+        }
+        if (!producedContextByScanner.has(dependency.scanner)) {
+            throw new Error(`Scanner '${definition.id}' depends on '${dependency.scanner}', but its context contract is not declared.`);
+        }
+    }
+}
+function validateRequiredBindings(definition, dependencies, producedContextByScanner) {
+    const requiredBindings = definition.inputs.filter(isConsumedArtifactBinding).filter((binding) => binding.required);
+    for (const binding of requiredBindings) {
+        const isWired = dependencies.some((dependency) => {
+            return producedContextByScanner.get(dependency.scanner)?.key === binding.contract.key;
+        });
+        if (!isWired) {
+            throw new Error(`Scanner '${definition.id}' requires context '${binding.contract.key}', but no depends_on entry wires a source scanner for it.`);
+        }
+    }
+}
+function validateActionReferences(config, nodes) {
+    for (const action of config.actions ?? []) {
+        for (const scannerId of action.scanners ?? []) {
+            const source = nodes.get(scannerId);
+            if (!source) {
+                throw new Error(`Action '${action.name}' references unknown trigger scanner '${scannerId}'.`);
+            }
+            if (!source.outputs.signals) {
+                throw new Error(`Action '${action.name}' uses '${scannerId}' as a trigger scanner, but that scanner does not emit signals.`);
+            }
+        }
+        for (const entry of action.context ?? []) {
+            if (entry.type === "signal") {
+                const source = nodes.get(entry.scanner);
+                if (!source) {
+                    throw new Error(`Action '${action.name}' references unknown signal scanner '${entry.scanner}'.`);
+                }
+                if (!source.outputs.signals) {
+                    throw new Error(`Action '${action.name}' requests signal context from '${entry.scanner}', but that scanner does not emit signals.`);
+                }
+            }
+            if (entry.type === "context") {
+                const source = nodes.get(entry.scanner);
+                if (!source) {
+                    throw new Error(`Action '${action.name}' references unknown context scanner '${entry.scanner}'.`);
+                }
+                if (!source.outputs.context) {
+                    throw new Error(`Action '${action.name}' requests retained context from '${entry.scanner}', but that scanner does not publish context.`);
+                }
+            }
+        }
+    }
+}
+function topologicallySort(nodes, graph) {
+    const visiting = new Set();
+    const visited = new Set();
+    const order = [];
+    const visit = (scannerId, path) => {
+        if (visited.has(scannerId)) {
+            return;
+        }
+        if (visiting.has(scannerId)) {
+            const cycle = [...path, scannerId].join(" -> ");
+            throw new Error(`Scanner dependency cycle detected: ${cycle}`);
+        }
+        visiting.add(scannerId);
+        for (const dependency of graph.get(scannerId) ?? []) {
+            visit(dependency, [...path, scannerId]);
+        }
+        visiting.delete(scannerId);
+        visited.add(scannerId);
+        order.push(scannerId);
+    };
+    for (const scannerId of nodes.keys()) {
+        visit(scannerId, []);
+    }
+    return order;
+}
+//# sourceMappingURL=scanner-composition.js.map

package/dist/runtime/scanner-composition.js.map

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

package/dist/runtime/scanner-registry.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Scanner type registry: map type string to Scanner factory.
+ */
+import type { Scanner } from "../scanners/protocol/scanner.js";
+export type ScannerFactory = () => Scanner<any, any>;
+/** Registers one scanner factory under a runtime type alias. */
+declare function register(type: string, factory: ScannerFactory): void;
+/** Returns the scanner factory currently associated with one runtime type alias. */
+declare function get(type: string): ScannerFactory | undefined;
+/**
+ * Create a scanner factory for the given type, with YAML name as the runtime id.
+ * The returned factory builds a fresh scanner instance for each registration and
+ * shallow-merges any YAML-level config overrides onto the scanner's default config.
+ */
+declare function createScanner(type: string, yamlName: string, configOverrides?: unknown, dependsOn?: Array<{
+    scanner: string;
+    required?: boolean;
+    max_age?: string;
+    on_missing?: "fail" | "skip" | "degrade";
+    on_stale?: "fail" | "skip" | "degrade";
+}>): ScannerFactory;
+export declare const ScannerRegistry: {
+    register: typeof register;
+    get: typeof get;
+    createScanner: typeof createScanner;
+};
+export {};
+//# sourceMappingURL=scanner-registry.d.ts.map

package/dist/runtime/scanner-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner-registry.d.ts","sourceRoot":"","sources":["../../src/runtime/scanner-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAc/D,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAIrD,gEAAgE;AAChE,iBAAS,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAE7D;AAED,oFAAoF;AACpF,iBAAS,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAErD;AAED;;;;GAIG;AACH,iBAAS,aAAa,CACpB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,OAAO,EACzB,SAAS,CAAC,EAAE,KAAK,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACxC,CAAC,GACD,cAAc,CAqBhB;AAoFD,eAAO,MAAM,eAAe;;;;CAI3B,CAAC"}

package/dist/runtime/scanner-registry.js

@@ -0,0 +1,114 @@
+/**
+ * Scanner type registry: map type string to Scanner factory.
+ */
+import { emergingMoversScanner } from "../scanners/implementations/emerging-movers.js";
+import { momentumScanner } from "../scanners/implementations/momentum.js";
+import { oiTrackerScanner } from "../scanners/implementations/oi-tracker.js";
+import { prescreenerScanner } from "../scanners/implementations/prescreener.js";
+import { liquidationWatchdogScanner } from "../scanners/implementations/liquidation-watchdog.js";
+import { marketRegimeScanner } from "../scanners/implementations/market-regime.js";
+import { smFlipScanner } from "../scanners/implementations/sm-flip.js";
+import { opportunityScanner } from "../scanners/implementations/opportunity.js";
+import { positionTrackerScanner } from "../scanners/implementations/position-tracker.js";
+import { parseInterval } from "./parse-interval.js";
+const registry = new Map();
+/** Registers one scanner factory under a runtime type alias. */
+function register(type, factory) {
+    registry.set(type, factory);
+}
+/** Returns the scanner factory currently associated with one runtime type alias. */
+function get(type) {
+    return registry.get(type);
+}
+/**
+ * Create a scanner factory for the given type, with YAML name as the runtime id.
+ * The returned factory builds a fresh scanner instance for each registration and
+ * shallow-merges any YAML-level config overrides onto the scanner's default config.
+ */
+function createScanner(type, yamlName, configOverrides, dependsOn) {
+    const factory = registry.get(type);
+    if (!factory) {
+        throw new Error(`Unknown scanner type: ${type}`);
+    }
+    return () => {
+        const scanner = factory();
+        const definition = {
+            ...scanner.definition,
+            id: yamlName,
+            dependsOn: mapScannerDependencies(yamlName, dependsOn),
+            defaultConfig: mergeConfigOverrides(scanner.definition.defaultConfig, configOverrides),
+        };
+        return {
+            ...scanner,
+            definition,
+        };
+    };
+}
+function mapScannerDependencies(scannerId, dependsOn) {
+    if (!dependsOn || dependsOn.length === 0) {
+        return undefined;
+    }
+    return dependsOn.map((dependency) => {
+        const maxAgeMs = dependency.max_age
+            ? parseDependencyDuration(scannerId, dependency.scanner, dependency.max_age)
+            : undefined;
+        return {
+            scanner: dependency.scanner,
+            required: dependency.required,
+            maxAgeMs,
+            onMissing: dependency.on_missing,
+            onStale: dependency.on_stale,
+        };
+    });
+}
+function parseDependencyDuration(targetScannerId, dependencyScannerId, raw) {
+    try {
+        return parseInterval(raw) * 1000;
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Invalid depends_on.max_age '${raw}' for scanner '${targetScannerId}' dependency '${dependencyScannerId}': ${detail}`);
+    }
+}
+/**
+ * Applies runtime config overrides coming from trading strategy YAML registration.
+ * Object-shaped overrides are shallow-merged so omitted fields still inherit
+ * the scanner's built-in defaults.
+ */
+function mergeConfigOverrides(defaultConfig, overrides) {
+    if (overrides === undefined) {
+        return defaultConfig;
+    }
+    if (isRecord(defaultConfig) && isRecord(overrides)) {
+        return {
+            ...defaultConfig,
+            ...structuredClone(overrides),
+        };
+    }
+    return structuredClone(overrides);
+}
+/** Narrow runtime config overrides to plain object values before attempting a merge. */
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+register("emerging_movers", emergingMoversScanner);
+register("emerging-movers", emergingMoversScanner);
+register("momentum", momentumScanner);
+register("oi_tracker", oiTrackerScanner);
+register("oi-tracker", oiTrackerScanner);
+register("prescreener", prescreenerScanner);
+register("liquidation_watchdog", liquidationWatchdogScanner);
+register("liquidation-watchdog", liquidationWatchdogScanner);
+register("market_regime", marketRegimeScanner);
+register("market-regime", marketRegimeScanner);
+register("sm_flip", smFlipScanner);
+register("sm-flip", smFlipScanner);
+register("opportunity", opportunityScanner);
+register("position_tracker", positionTrackerScanner);
+register("position-tracker", positionTrackerScanner);
+export const ScannerRegistry = {
+    register,
+    get,
+    createScanner,
+};
+//# sourceMappingURL=scanner-registry.js.map

package/dist/runtime/scanner-registry.js.map

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

package/dist/runtime/state-layout.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Canonical state-directory layout helpers and archive operations.
+ *
+ * The runtime uses these to build deterministic per-runtime state paths
+ * and to archive state directories when runtimes are deleted.
+ */
+/**
+ * Describes the explicit paths the runtime provides to each component.
+ * Components must store their state only within the path they receive.
+ */
+export interface StateLayout {
+    /** Runtime state root (e.g. `<baseStateDir>/<runtimeId>-<wallet>`). */
+    root: string;
+    /** Root passed to scanner stores (same as `root` today; scanners add `strategies/<wallet>/...` internally). */
+    scannerRoot: string;
+    /** Root passed to StateManager / DslPlugin (same as `root`; they add `<wallet>/dsl-*` internally). */
+    dslRoot: string;
+}
+/**
+ * Build the per-runtime state directory path.
+ * Convention: `<baseStateDir>/<runtimeId>-<wallet>`.
+ */
+export declare function buildRuntimeStateDir(baseStateDir: string, runtimeId: string, wallet: string): string;
+/** @deprecated Use buildRuntimeStateDir */
+export declare const buildRecipeStateDir: typeof buildRuntimeStateDir;
+/**
+ * Build a `StateLayout` from a runtime's state directory.
+ * Currently all roots resolve to the same directory; kept explicit so
+ * a future version can split them without changing call-sites.
+ */
+export declare function buildStateLayout(runtimeStateDir: string): StateLayout;
+export interface ArchiveEntry {
+    path: string;
+    runtimeId: string;
+    wallet: string;
+    timestamp: number;
+}
+/**
+ * Archive a runtime's state directory by moving it into the archives folder.
+ * Target: `<archiveBaseDir>/<runtimeId>-<wallet>-<timestamp>/`.
+ * Falls back to recursive copy + remove when `rename` fails (cross-device).
+ * Returns the archive destination path.
+ */
+export declare function archiveStateDir(runtimeStateDir: string, archiveBaseDir: string, runtimeId: string, wallet: string): Promise<string>;
+/**
+ * List archived runtime state directories, sorted newest-first.
+ * Parses directory names matching `<runtimeId>-<wallet>-<timestamp>`.
+ */
+export declare function listArchives(archiveBaseDir: string): Promise<ArchiveEntry[]>;
+//# sourceMappingURL=state-layout.d.ts.map

package/dist/runtime/state-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-layout.d.ts","sourceRoot":"","sources":["../../src/runtime/state-layout.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,+GAA+G;IAC/G,WAAW,EAAE,MAAM,CAAC;IACpB,sGAAsG;IACtG,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpG;AAED,2CAA2C;AAC3C,eAAO,MAAM,mBAAmB,6BAAuB,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,WAAW,CAMrE;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAajB;AAID;;;GAGG;AACH,wBAAsB,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAgClF"}

package/dist/runtime/state-layout.js

@@ -0,0 +1,89 @@
+/**
+ * Canonical state-directory layout helpers and archive operations.
+ *
+ * The runtime uses these to build deterministic per-runtime state paths
+ * and to archive state directories when runtimes are deleted.
+ */
+import { join } from "node:path";
+import { mkdir, rename, readdir, cp, rm, stat } from "node:fs/promises";
+/**
+ * Build the per-runtime state directory path.
+ * Convention: `<baseStateDir>/<runtimeId>-<wallet>`.
+ */
+export function buildRuntimeStateDir(baseStateDir, runtimeId, wallet) {
+    return join(baseStateDir, `${runtimeId}-${wallet}`);
+}
+/** @deprecated Use buildRuntimeStateDir */
+export const buildRecipeStateDir = buildRuntimeStateDir;
+/**
+ * Build a `StateLayout` from a runtime's state directory.
+ * Currently all roots resolve to the same directory; kept explicit so
+ * a future version can split them without changing call-sites.
+ */
+export function buildStateLayout(runtimeStateDir) {
+    return {
+        root: runtimeStateDir,
+        scannerRoot: runtimeStateDir,
+        dslRoot: runtimeStateDir,
+    };
+}
+/**
+ * Archive a runtime's state directory by moving it into the archives folder.
+ * Target: `<archiveBaseDir>/<runtimeId>-<wallet>-<timestamp>/`.
+ * Falls back to recursive copy + remove when `rename` fails (cross-device).
+ * Returns the archive destination path.
+ */
+export async function archiveStateDir(runtimeStateDir, archiveBaseDir, runtimeId, wallet) {
+    await mkdir(archiveBaseDir, { recursive: true });
+    const ts = Date.now();
+    const archiveName = `${runtimeId}-${wallet}-${ts}`;
+    const dest = join(archiveBaseDir, archiveName);
+    try {
+        await rename(runtimeStateDir, dest);
+    }
+    catch {
+        await cp(runtimeStateDir, dest, { recursive: true });
+        await rm(runtimeStateDir, { recursive: true, force: true });
+    }
+    return dest;
+}
+const ARCHIVE_DIR_PATTERN = /^(.+)-([^-]+-[^-]+)$/;
+/**
+ * List archived runtime state directories, sorted newest-first.
+ * Parses directory names matching `<runtimeId>-<wallet>-<timestamp>`.
+ */
+export async function listArchives(archiveBaseDir) {
+    let entries;
+    try {
+        entries = await readdir(archiveBaseDir);
+    }
+    catch {
+        return [];
+    }
+    const results = [];
+    for (const name of entries) {
+        const fullPath = join(archiveBaseDir, name);
+        let info;
+        try {
+            info = await stat(fullPath);
+        }
+        catch {
+            continue;
+        }
+        if (!info.isDirectory())
+            continue;
+        const m = ARCHIVE_DIR_PATTERN.exec(name);
+        if (!m)
+            continue;
+        const [, runtimeId, walletAndTs] = m;
+        const tsDash = walletAndTs.lastIndexOf("-");
+        const wallet = walletAndTs.slice(0, tsDash);
+        const ts = Number(walletAndTs.slice(tsDash + 1));
+        if (!Number.isFinite(ts) || ts <= 0)
+            continue;
+        results.push({ path: fullPath, runtimeId, wallet, timestamp: ts });
+    }
+    results.sort((a, b) => b.timestamp - a.timestamp);
+    return results;
+}
+//# sourceMappingURL=state-layout.js.map

package/dist/runtime/state-layout.js.map

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

package/dist/runtime/strategy-registry.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Internal registry of installed runtimes (installed_runtimes.json).
+ * Source of truth for what the plugin should run; read on boot, updated by CLI/RPC install/uninstall.
+ * Each entry uses exactly one of runtimeYamlPath or runtimeYamlContent (see InstalledRuntimeEntry).
+ * Migrates from installed_recipes.json and installed_strategies.json on first read if present.
+ */
+export declare const REGISTRY_FILENAME = "installed_runtimes.json";
+export interface InstalledRuntimeEntry {
+    id: string;
+    runtimeYamlPath?: string;
+    runtimeYamlContent?: string;
+    /** Major version extracted from YAML version field at install time. */
+    schemaVersion?: number;
+    /** Wallet address from strategy.wallet, stored at install time. */
+    wallet?: string;
+}
+export interface InstalledRuntimeRegistry {
+    version: number;
+    runtimes: InstalledRuntimeEntry[];
+}
+/** @deprecated Use InstalledRuntimeEntry */
+export type InstalledRecipeEntry = InstalledRuntimeEntry;
+/** @deprecated Use InstalledRuntimeRegistry */
+export type InstalledRecipesRegistry = InstalledRuntimeRegistry;
+/** @deprecated Use InstalledRuntimeEntry */
+export type InstalledStrategyEntry = InstalledRuntimeEntry;
+/** @deprecated Use InstalledRuntimeRegistry */
+export type InstalledStrategiesRegistry = InstalledRuntimeRegistry;
+/**
+ * Sanitize a string for use as registry id: replace non-alphanumeric with underscore, truncate.
+ */
+export declare function sanitizeId(candidate: string): string;
+/**
+ * Derive a human-readable, globally-unique runtime id from the YAML name and wallet.
+ * Format: `<slugified-name>-<4-char hash>` (e.g. "fox-strategy-a7k2").
+ * The hash is derived from name + wallet + timestamp + monotonic counter,
+ * so re-creating a runtime with the same name always produces a distinct id
+ * (no archive collisions).
+ */
+export declare function deriveRuntimeId(name: string, wallet: string): string;
+/** @deprecated Use deriveRuntimeId */
+export declare const deriveRecipeId: typeof deriveRuntimeId;
+/**
+ * Derive default id from file path (basename without extension).
+ * @deprecated Prefer deriveRuntimeId(name, wallet) which uses the YAML name field.
+ */
+export declare function deriveIdFromPath(filePath: string, existingIds: string[]): string;
+/**
+ * Derive default id for content-only entry: content-0, content-1, ...
+ */
+export declare function deriveIdForContent(existingIds: string[]): string;
+/**
+ * Read the installed runtimes registry from stateDir.
+ * Migrates from installed_recipes.json or installed_strategies.json if present.
+ * Missing or invalid file returns { version: 1, runtimes: [] }.
+ */
+export declare function readRegistry(stateDir: string): Promise<InstalledRuntimeRegistry>;
+/**
+ * Write the registry atomically (temp file then rename).
+ */
+export declare function writeRegistry(stateDir: string, data: InstalledRuntimeRegistry): Promise<void>;
+/**
+ * Validate that an entry has exactly one of runtimeYamlPath or runtimeYamlContent and id is safe.
+ */
+export declare function validateEntry(entry: InstalledRuntimeEntry): {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Check if an id is already present in the registry.
+ */
+export declare function hasId(registry: InstalledRuntimeRegistry, id: string): boolean;
+/**
+ * Find a registry entry by wallet address.
+ */
+export declare function findByWallet(registry: InstalledRuntimeRegistry, wallet: string): InstalledRuntimeEntry | undefined;
+//# sourceMappingURL=strategy-registry.d.ts.map

package/dist/runtime/strategy-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-registry.d.ts","sourceRoot":"","sources":["../../src/runtime/strategy-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAI3D,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAED,4CAA4C;AAC5C,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAEzD,+CAA+C;AAC/C,MAAM,MAAM,wBAAwB,GAAG,wBAAwB,CAAC;AAEhE,4CAA4C;AAC5C,MAAM,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AAE3D,+CAA+C;AAC/C,MAAM,MAAM,2BAA2B,GAAG,wBAAwB,CAAC;AAoCnE;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKpD;AAID;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAYpE;AAED,sCAAsC;AACtC,eAAO,MAAM,cAAc,wBAAkB,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAYhF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAShE;AA4BD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAgEtF;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,qBAAqB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAiBvG;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,wBAAwB,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAE7E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,wBAAwB,EAAE,MAAM,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAElH"}