@rotifer/playground 0.8.6 → 0.9.0

package/dist/types/phenotype.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Phenotype type definitions — v0.9.1 §3.3 (ADR-253 D4.4 + ADR-277 D7 L3).
+ *
+ * Single source of truth for Phenotype field schemas in TypeScript. The
+ * runtime validator (`utils/phenotype-validator.ts`) imports the const
+ * arrays from here so the enum surface stays in sync between type-check
+ * time and runtime validation.
+ *
+ * Spec alignment: §4.2 RotiferGeneSpec. The `executionModel` field is
+ * pending L2 Spec Patch (Tier 2) — track via Plan §3.3.
+ */
+/**
+ * Declares how a Gene is consumed at runtime.
+ *
+ * - `CHAT`: Conversational Agent (chat URL surface applies — rotifer.ai
+ *   `/agents/[creator]/[name]` renders a chat interface).
+ * - `BATCH`: Synchronous function-call style invocation. Default for legacy
+ *   v0.8.x Genes that pre-date this enum.
+ * - `EVENT_DRIVEN`: Triggered by external events (cron, webhook, message).
+ *
+ * Absent field is treated as `BATCH` at runtime for backward compatibility
+ * with pre-§3.3 published Genes.
+ */
+export type ExecutionModel = "CHAT" | "BATCH" | "EVENT_DRIVEN";
+export declare const EXECUTION_MODELS: readonly ExecutionModel[];
+export type SynthesisMethod = "MANUAL" | "LLM_ASSISTED" | "LLM_AUTO" | "MUTATION" | "DE_NOVO";
+export declare const SYNTHESIS_METHODS: readonly SynthesisMethod[];
+export type Fidelity = "Wrapped" | "Hybrid" | "Native" | "Unknown";
+/**
+ * Gene source-code transparency (spec §4.2 `GeneTransparency`, §10.4). Mirrors
+ * the Rust IR `GeneTransparency`. Spec serialises UPPERCASE; legacy PascalCase
+ * literals are accepted with a deprecation warning until v0.9.2 (see
+ * `LEGACY_GENE_TRANSPARENCIES`).
+ */
+export type GeneTransparency = "OPEN" | "OPAQUE";
+export declare const GENE_TRANSPARENCIES: readonly GeneTransparency[];
+/** Pre-§3.3 PascalCase transparency literals → spec UPPERCASE. Removed v0.9.2. */
+export declare const LEGACY_GENE_TRANSPARENCIES: Readonly<Record<string, GeneTransparency>>;
+/**
+ * FIDELITY_DISCOUNT — protocol parameter (spec §5.1 v2.11).
+ *
+ * Multiplied into F(g) so that Native, Hybrid, and Wrapped genes can compete
+ * on a single Arena ranking without privileging external-API-shaped genes.
+ *
+ *   F(g) = base_fitness × FIDELITY_DISCOUNT[gene.fidelity]
+ *
+ * Keys are the lowercase canonical form (Q2=c 2026-05-28 — case
+ * normalization between spec enum (UPPER) and runtime keys (lower) is
+ * deferred to Phase 5 / v0.9.1; current binding implementations should
+ * normalize via lowercasing before lookup).
+ *
+ * PAP minor adjustment: Δ ≤ 0.05 per discount tier per cycle (spec §14.6).
+ */
+export declare const FIDELITY_DISCOUNT: Readonly<Record<string, number>>;
+/**
+ * Semantic-layer external API dependency declaration.
+ *
+ * Complements the protocol-layer NetworkConfig — `network` declares the
+ * sandbox's domain whitelist + timeouts, while `externalDependencies`
+ * declares the *semantic* contract (what kind of service, expected SLA,
+ * and degradation behavior).
+ *
+ * Spec §4.2 v2.11; v0.9 plan §3.11 (A2=b decision); ADR-220 §"D-04".
+ */
+export interface ExternalDependency {
+    /** Protocol family — "rest" | "graphql" | "grpc" | "websocket". */
+    apiType: string;
+    /** Semantic identifier (e.g. "cve-database", "llm-judge", "git-cli"). */
+    semanticTag: string;
+    /** Optional expected SLA. */
+    sla?: {
+        expectedLatency?: number;
+        expectedAvailability?: number;
+    };
+    /**
+     * How the gene behaves when this dependency is unreachable — the
+     * external-dependency axis (spec §4.2 `DegradationBehavior`), one of three
+     * orthogonal degradation axes (ADR-220 E2, ADR-297): external-dependency
+     * behavior ⊥ degradation mode (`DegradationSpec.mode`) ⊥ eventual failure
+     * semantics. Mirrors the Rust IR `ExternalDependencyBehavior`. The legacy
+     * PascalCase literals still validate with a deprecation warning through the
+     * v0.9.1 grace window (see `LEGACY_DEGRADATION_BEHAVIORS`; removed v0.9.2).
+     */
+    degradationBehavior: ExternalDependencyBehavior;
+}
+/** Spec §4.2 `DegradationBehavior` — external-dependency unreachable behavior. */
+export type ExternalDependencyBehavior = "FAIL" | "FALLBACK" | "CACHE" | "SKIP";
+export declare const DEGRADATION_BEHAVIORS: readonly ExternalDependencyBehavior[];
+/**
+ * Legacy `degradationBehavior` literals (the pre-§3.3 collapsed 5-variant set)
+ * mapped to their spec replacement. Accepted with a deprecation warning through
+ * the v0.9.1 grace window; removed in v0.9.2 (ADR-297 D3 phase 4). The two
+ * transaction-axis values (PartialRetry / AtomicRollback) were mis-merged into
+ * this dependency axis and map to the closest dependency behavior.
+ */
+export declare const LEGACY_DEGRADATION_BEHAVIORS: Readonly<Record<string, ExternalDependencyBehavior>>;
+/**
+ * Spec §45 `FailureSemantics` — the transaction (eventual-failure) axis,
+ * orthogonal to `degradationBehavior`. Mirrors the Rust IR
+ * `EventualFailureSemantics`; enforced on the IR side (no TS phenotype field
+ * consumes it yet) and declared here for cross-language parity.
+ */
+export type EventualFailureSemantics = "ATOMIC_ROLLBACK" | "PARTIAL_RETRY" | "SILENT_DEGRADE" | "FAIL_FAST";
+/**
+ * Dry-run protocol declaration (ADR-220 T1, "Tesla mind simulation" pattern).
+ *
+ * Spec §4.2 v2.11; v0.9 plan §3.11.
+ */
+export interface SimulationSpec {
+    supportsDryRun: boolean;
+    /** Inline expression that generates representative test input. */
+    syntheticInputGenerator?: string;
+    /** Inline expression that validates dry-run output. */
+    expectedOutputValidator?: string;
+    resourceEstimate: {
+        estimatedLatencyMs: number;
+        /** SHOULD for LLM-Native genes. */
+        estimatedTokens?: number;
+    };
+}
+/**
+ * Graceful degradation declaration (ADR-220 E2, "Euler post-blindness").
+ *
+ * Spec §4.2 v2.11; v0.9 plan §3.11.
+ */
+export interface DegradationSpec {
+    mode: "FAIL_FAST" | "PARTIAL_OUTPUT" | "FALLBACK_LOGIC";
+    /** SHOULD for PARTIAL_OUTPUT mode — schema of degraded output. */
+    fallbackOutputSchema?: unknown;
+    /** Set of `externalDependencies[].semanticTag` values whose absence is tolerable. */
+    minimumDependencies: string[];
+}
+export declare const DEGRADATION_MODES: readonly DegradationSpec["mode"][];
+export type TemplateFormat = "mustache" | "handlebars" | "jinja2" | "fstring" | "raw";
+export declare const TEMPLATE_FORMATS: readonly TemplateFormat[];
+export type GuardPosition = "input" | "output" | "both";
+export declare const GUARD_POSITIONS: readonly GuardPosition[];
+export interface LlmRequirements {
+    templateFormat?: TemplateFormat;
+    templateVariables?: string[];
+}
+export interface GuardConfig {
+    position?: GuardPosition;
+    categories?: string[];
+    riskThreshold?: number;
+}
+/**
+ * Phenotype is the metadata + behavioral declaration block of a Gene.
+ *
+ * v0.9.1 §3.3 adds `executionModel` (and forward-compat optional `systemPrompt`
+ * for CHAT mode) per ADR-253 D4.4 + ADR-256 D4.
+ *
+ * All fields are optional at the type level — runtime validation enforces
+ * which combinations are required (see `phenotype-validator.ts`).
+ */
+export interface Phenotype {
+    name?: string;
+    domain?: string;
+    version?: string;
+    fidelity?: Fidelity;
+    /** Source-code transparency (spec §4.2). Optional; legacy genes lack it. */
+    transparency?: GeneTransparency;
+    description?: string;
+    synthesisMethod?: SynthesisMethod;
+    inputSchema?: unknown;
+    outputSchema?: unknown;
+    executionModel?: ExecutionModel;
+    /**
+     * Optional system prompt for CHAT mode. Consumed by the rotifer.ai chat
+     * surface as the Agent's initial system message. Ignored for non-CHAT
+     * executionModel (validator emits W0101 if set).
+     */
+    systemPrompt?: string;
+    llmRequirements?: LlmRequirements;
+    guardConfig?: GuardConfig;
+    externalDependencies?: ExternalDependency[];
+    simulationSpec?: SimulationSpec;
+    degradationSpec?: DegradationSpec;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=phenotype.d.ts.map

package/dist/types/phenotype.d.ts.map

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

package/dist/types/phenotype.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * Phenotype type definitions — v0.9.1 §3.3 (ADR-253 D4.4 + ADR-277 D7 L3).
+ *
+ * Single source of truth for Phenotype field schemas in TypeScript. The
+ * runtime validator (`utils/phenotype-validator.ts`) imports the const
+ * arrays from here so the enum surface stays in sync between type-check
+ * time and runtime validation.
+ *
+ * Spec alignment: §4.2 RotiferGeneSpec. The `executionModel` field is
+ * pending L2 Spec Patch (Tier 2) — track via Plan §3.3.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GUARD_POSITIONS = exports.TEMPLATE_FORMATS = exports.DEGRADATION_MODES = exports.LEGACY_DEGRADATION_BEHAVIORS = exports.DEGRADATION_BEHAVIORS = exports.FIDELITY_DISCOUNT = exports.LEGACY_GENE_TRANSPARENCIES = exports.GENE_TRANSPARENCIES = exports.SYNTHESIS_METHODS = exports.EXECUTION_MODELS = void 0;
+exports.EXECUTION_MODELS = [
+    "CHAT",
+    "BATCH",
+    "EVENT_DRIVEN",
+];
+exports.SYNTHESIS_METHODS = [
+    "MANUAL",
+    "LLM_ASSISTED",
+    "LLM_AUTO",
+    "MUTATION",
+    "DE_NOVO",
+];
+exports.GENE_TRANSPARENCIES = ["OPEN", "OPAQUE"];
+/** Pre-§3.3 PascalCase transparency literals → spec UPPERCASE. Removed v0.9.2. */
+exports.LEGACY_GENE_TRANSPARENCIES = Object.freeze({
+    Open: "OPEN",
+    Opaque: "OPAQUE",
+});
+// ─── Hybrid Fidelity (Spec §4.2 v2.11 + §3.11 v0.9 plan + ADR-220) ───────────
+/**
+ * FIDELITY_DISCOUNT — protocol parameter (spec §5.1 v2.11).
+ *
+ * Multiplied into F(g) so that Native, Hybrid, and Wrapped genes can compete
+ * on a single Arena ranking without privileging external-API-shaped genes.
+ *
+ *   F(g) = base_fitness × FIDELITY_DISCOUNT[gene.fidelity]
+ *
+ * Keys are the lowercase canonical form (Q2=c 2026-05-28 — case
+ * normalization between spec enum (UPPER) and runtime keys (lower) is
+ * deferred to Phase 5 / v0.9.1; current binding implementations should
+ * normalize via lowercasing before lookup).
+ *
+ * PAP minor adjustment: Δ ≤ 0.05 per discount tier per cycle (spec §14.6).
+ */
+exports.FIDELITY_DISCOUNT = Object.freeze({
+    native: 1.0,
+    hybrid: 0.85,
+    wrapped: 0.7,
+});
+exports.DEGRADATION_BEHAVIORS = [
+    "FAIL",
+    "FALLBACK",
+    "CACHE",
+    "SKIP",
+];
+/**
+ * Legacy `degradationBehavior` literals (the pre-§3.3 collapsed 5-variant set)
+ * mapped to their spec replacement. Accepted with a deprecation warning through
+ * the v0.9.1 grace window; removed in v0.9.2 (ADR-297 D3 phase 4). The two
+ * transaction-axis values (PartialRetry / AtomicRollback) were mis-merged into
+ * this dependency axis and map to the closest dependency behavior.
+ */
+exports.LEGACY_DEGRADATION_BEHAVIORS = Object.freeze({
+    FailFast: "FAIL",
+    SilentDegrade: "FALLBACK",
+    Retry: "CACHE",
+    PartialRetry: "CACHE",
+    AtomicRollback: "FAIL",
+});
+exports.DEGRADATION_MODES = [
+    "FAIL_FAST",
+    "PARTIAL_OUTPUT",
+    "FALLBACK_LOGIC",
+];
+exports.TEMPLATE_FORMATS = [
+    "mustache",
+    "handlebars",
+    "jinja2",
+    "fstring",
+    "raw",
+];
+exports.GUARD_POSITIONS = ["input", "output", "both"];
+//# sourceMappingURL=phenotype.js.map

package/dist/types/phenotype.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phenotype.js","sourceRoot":"","sources":["../../src/types/phenotype.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAkBU,QAAA,gBAAgB,GAA8B;IACzD,MAAM;IACN,OAAO;IACP,cAAc;CACN,CAAC;AAWE,QAAA,iBAAiB,GAA+B;IAC3D,QAAQ;IACR,cAAc;IACd,UAAU;IACV,UAAU;IACV,SAAS;CACD,CAAC;AAcE,QAAA,mBAAmB,GAAgC,CAAC,MAAM,EAAE,QAAQ,CAAU,CAAC;AAE5F,kFAAkF;AACrE,QAAA,0BAA0B,GAA+C,MAAM,CAAC,MAAM,CAAC;IAClG,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;CACjB,CAAC,CAAC;AAEH,gFAAgF;AAEhF;;;;;;;;;;;;;;GAcG;AACU,QAAA,iBAAiB,GAAqC,MAAM,CAAC,MAAM,CAAC;IAC/E,MAAM,EAAE,GAAG;IACX,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,GAAG;CACb,CAAC,CAAC;AAqCU,QAAA,qBAAqB,GAA0C;IAC1E,MAAM;IACN,UAAU;IACV,OAAO;IACP,MAAM;CACE,CAAC;AAEX;;;;;;GAMG;AACU,QAAA,4BAA4B,GACvC,MAAM,CAAC,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM;IAChB,aAAa,EAAE,UAAU;IACzB,KAAK,EAAE,OAAO;IACd,YAAY,EAAE,OAAO;IACrB,cAAc,EAAE,MAAM;CACvB,CAAC,CAAC;AA6CQ,QAAA,iBAAiB,GAAuC;IACnE,WAAW;IACX,gBAAgB;IAChB,gBAAgB;CACR,CAAC;AAME,QAAA,gBAAgB,GAA8B;IACzD,UAAU;IACV,YAAY;IACZ,QAAQ;IACR,SAAS;IACT,KAAK;CACG,CAAC;AAIE,QAAA,eAAe,GAA6B,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC"}

package/dist/utils/binding.d.ts

@@ -37,11 +37,35 @@ export interface NativeBinding {
     l0Check(phenotypeJson: string, permissionsJson?: string, constraintsJson?: string): L0CheckResultView;
     executeAlgebra(algebraJson: string, geneEntriesJson: string, inputJson: string): AlgebraResultView;
 }
+export declare function tryLoadBinding(): NativeBinding | null;
+/** A gene announcement received from a peer (mirrors the Rust napi struct). */
+export interface ReceivedAnnouncement {
+    geneId: string;
+    name: string;
+    domain: string;
+    version: string;
+    fidelity: string;
+    publisher: string;
+    source?: string;
+}
 /**
- * Try to load the napi native addon.
- * Strategy: platform npm package first, then local .node file fallback.
- * Returns null if the addon is not available (fallback to pure-TS path).
+ * Subset of the native `P2pNode` class surfaced to the CLI. Method names are
+ * camelCase (napi converts the Rust snake_case automatically).
  */
-export declare function tryLoadBinding(): NativeBinding | null;
+export interface P2pNodeHandle {
+    start(): void;
+    peerId(): string;
+    listenAddrs(): string[];
+    discoveredPeers(): string[];
+    receivedAnnouncements(): ReceivedAnnouncement[];
+    announceGene(geneId: string, name: string, domain: string, version: string, fidelity: string): void;
+    stop(): void;
+}
+/**
+ * Construct a native libp2p P2P node. Returns null when the native addon is
+ * unavailable (e.g. a pure-TS environment without the compiled `.node`), so
+ * callers can degrade gracefully.
+ */
+export declare function loadP2pNode(listenHost: string, listenPort: number, bootstrapPeers: string[]): P2pNodeHandle | null;
 export declare function isNativeAvailable(): boolean;
 //# sourceMappingURL=binding.d.ts.map

package/dist/utils/binding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/utils/binding.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,iBAAiB,CAAC;IACrB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1C,iBAAiB,IAAI,MAAM,CAAC;IAC5B,mBAAmB,IAAI,MAAM,CAAC;IAC9B,sBAAsB,IAAI,MAAM,CAAC;IACjC,sBAAsB,IAAI,MAAM,CAAC;IACjC,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,eAAe,CAAC,EAAE,MAAM,GACvB,mBAAmB,CAAC;IACvB,OAAO,CACL,aAAa,EAAE,MAAM,EACrB,eAAe,CAAC,EAAE,MAAM,EACxB,eAAe,CAAC,EAAE,MAAM,GACvB,iBAAiB,CAAC;IACrB,cAAc,CACZ,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAAC;CACtB;AAuBD;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,aAAa,GAAG,IAAI,CAmCrD;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/utils/binding.ts"],"names":[],"mappings":"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"}

package/dist/utils/binding.js

@@ -1,12 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.tryLoadBinding = tryLoadBinding;
+exports.loadP2pNode = loadP2pNode;
 exports.isNativeAvailable = isNativeAvailable;
 const node_path_1 = require("node:path");
 const node_fs_1 = require("node:fs");
 const private_fs_js_1 = require("./private-fs.js");
 let _binding = null;
 let _hasLoadAttempted = false;
+let _rawModule = null;
+let _hasModuleLoadAttempted = false;
 const PLATFORM_PACKAGE_MAP = {
     "darwin-arm64": "@rotifer/playground-darwin-arm64",
     "darwin-x64": "@rotifer/playground-darwin-x64",
@@ -25,18 +28,16 @@ function initBinding(mod) {
  * Strategy: platform npm package first, then local .node file fallback.
  * Returns null if the addon is not available (fallback to pure-TS path).
  */
-function tryLoadBinding() {
-    if (_hasLoadAttempted)
-        return _binding;
-    _hasLoadAttempted = true;
+function loadRawModule() {
+    if (_hasModuleLoadAttempted)
+        return _rawModule;
+    _hasModuleLoadAttempted = true;
     const platformKey = `${process.platform}-${process.arch}`;
     const pkgName = PLATFORM_PACKAGE_MAP[platformKey];
     if (pkgName) {
         try {
-            const mod = require(pkgName);
-            _binding = initBinding(mod);
-            if (_binding)
-                return _binding;
+            _rawModule = require(pkgName);
+            return _rawModule;
         }
         catch {
             // platform package not installed — fall through to local search
@@ -50,10 +51,8 @@ function tryLoadBinding() {
     for (const candidate of localCandidates) {
         if ((0, node_fs_1.existsSync)(candidate)) {
             try {
-                const mod = require(candidate);
-                _binding = initBinding(mod);
-                if (_binding)
-                    return _binding;
+                _rawModule = require(candidate);
+                return _rawModule;
             }
             catch {
                 // addon exists but failed to load — continue
@@ -62,6 +61,29 @@ function tryLoadBinding() {
     }
     return null;
 }
+function tryLoadBinding() {
+    if (_hasLoadAttempted)
+        return _binding;
+    _hasLoadAttempted = true;
+    const mod = loadRawModule();
+    if (mod)
+        _binding = initBinding(mod);
+    return _binding;
+}
+/**
+ * Construct a native libp2p P2P node. Returns null when the native addon is
+ * unavailable (e.g. a pure-TS environment without the compiled `.node`), so
+ * callers can degrade gracefully.
+ */
+function loadP2pNode(listenHost, listenPort, bootstrapPeers) {
+    const mod = loadRawModule();
+    // napi renders the Rust `P2pNode` as `P2PNode` (it uppercases the "p2p"
+    // acronym); accept either spelling so both the raw addon and any JS wrapper work.
+    const Ctor = (mod?.P2PNode ?? mod?.P2pNode);
+    if (typeof Ctor !== "function")
+        return null;
+    return new Ctor(listenHost, listenPort, bootstrapPeers);
+}
 function isNativeAvailable() {
     return tryLoadBinding() !== null;
 }

package/dist/utils/binding.js.map

@@ -1 +1 @@
-{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../src/utils/binding.ts"],"names":[],"mappings":";;AA2FA,wCAmCC;AAED,8CAEC;AAlID,yCAAiC;AACjC,qCAAqC;AACrC,mDAAmD;AA+DnD,IAAI,QAAQ,GAAyB,IAAI,CAAC;AAC1C,IAAI,iBAAiB,GAAG,KAAK,CAAC;AAE9B,MAAM,oBAAoB,GAA2B;IACnD,cAAc,EAAE,kCAAkC;IAClD,YAAY,EAAE,gCAAgC;IAC9C,WAAW,EAAE,mCAAmC;IAChD,WAAW,EAAE,oCAAoC;CAClD,CAAC;AAEF,SAAS,WAAW,CAAC,GAA4B;IAC/C,IAAI,CAAC,GAAG,CAAC,iBAAiB;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,MAAM,GAAG,IAAA,gBAAI,EACjB,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,EACrD,UAAU,EACV,cAAc,CACf,CAAC;IACF,IAAA,gCAAgB,EAAC,MAAM,CAAC,CAAC;IACzB,OAAO,IAAK,GAAG,CAAC,iBAAwD,CAAC,MAAM,CAAC,CAAC;AACnF,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc;IAC5B,IAAI,iBAAiB;QAAE,OAAO,QAAQ,CAAC;IACvC,iBAAiB,GAAG,IAAI,CAAC;IAEzB,MAAM,WAAW,GAAG,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAC1D,MAAM,OAAO,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAClD,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;YAC7B,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,QAAQ;gBAAE,OAAO,QAAQ,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,gEAAgE;QAClE,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG;QACtB,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,WAAW,OAAO,CAAC;QACxD,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,OAAO,CAAC;QAC7E,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,OAAO,CAAC;KACrF,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,eAAe,EAAE,CAAC;QACxC,IAAI,IAAA,oBAAU,EAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;gBAC/B,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;gBAC5B,IAAI,QAAQ;oBAAE,OAAO,QAAQ,CAAC;YAChC,CAAC;YAAC,MAAM,CAAC;gBACP,6CAA6C;YAC/C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,iBAAiB;IAC/B,OAAO,cAAc,EAAE,KAAK,IAAI,CAAC;AACnC,CAAC"}
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../src/utils/binding.ts"],"names":[],"mappings":"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"}

package/dist/utils/config.js

@@ -33,7 +33,7 @@ function saveConfig(config, projectDir) {
 function getProjectRoot() {
     const root = findProjectRoot();
     if (!root) {
-        throw new Error(`No ${CONFIG_FILE} found. Run 'rotifer init' to create a new project.`);
+        throw new Error(`No ${CONFIG_FILE} found. Run 'rotifer init' to create a new Agent workspace.`);
     }
     return root;
 }

package/dist/utils/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":";;AAaA,0CASC;AAED,gCAWC;AAED,gCAGC;AAED,wCAQC;AAlDD,qCAAkE;AAClE,yCAAiC;AAUjC,MAAM,WAAW,GAAG,cAAc,CAAC;AAEnC,SAAgB,eAAe,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IAC9D,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,OAAO,GAAG,KAAK,GAAG,EAAE,CAAC;QACnB,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;YACvC,OAAO,GAAG,CAAC;QACb,CAAC;QACD,GAAG,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,UAAU,CAAC,UAAmB;IAC5C,MAAM,IAAI,GAAG,UAAU,IAAI,eAAe,EAAE,CAAC;IAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,MAAM,WAAW,mCAAmC,CACrD,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAkB,CAAC;AAC9C,CAAC;AAED,SAAgB,UAAU,CAAC,MAAqB,EAAE,UAAkB;IAClE,MAAM,UAAU,GAAG,IAAA,gBAAI,EAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACjD,IAAA,uBAAa,EAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACpE,CAAC;AAED,SAAgB,cAAc;IAC5B,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,MAAM,WAAW,qDAAqD,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":";;AAaA,0CASC;AAED,gCAWC;AAED,gCAGC;AAED,wCAQC;AAlDD,qCAAkE;AAClE,yCAAiC;AAUjC,MAAM,WAAW,GAAG,cAAc,CAAC;AAEnC,SAAgB,eAAe,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IAC9D,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,OAAO,GAAG,KAAK,GAAG,EAAE,CAAC;QACnB,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;YACvC,OAAO,GAAG,CAAC;QACb,CAAC;QACD,GAAG,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,UAAU,CAAC,UAAmB;IAC5C,MAAM,IAAI,GAAG,UAAU,IAAI,eAAe,EAAE,CAAC;IAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,MAAM,WAAW,mCAAmC,CACrD,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAkB,CAAC;AAC9C,CAAC;AAED,SAAgB,UAAU,CAAC,MAAqB,EAAE,UAAkB;IAClE,MAAM,UAAU,GAAG,IAAA,gBAAI,EAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACjD,IAAA,uBAAa,EAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACpE,CAAC;AAED,SAAgB,cAAc;IAC5B,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,MAAM,WAAW,6DAA6D,CAC/E,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/javy-compiler.d.ts

@@ -1,3 +1,33 @@
+/** Gene source declares an async/Promise-returning express() — incompatible with Javy/QuickJS (#57). */
+export declare class AsyncExpressError extends Error {
+    name: string;
+}
+/** TS→WASM toolchain (esbuild / javy) unavailable; message carries the full diagnosis (#58). */
+export declare class ToolchainError extends Error {
+    name: string;
+}
+/**
+ * Detect an async/Promise-returning express() in gene source.
+ * Returns a human-readable description of the offending shape, or null if clean.
+ */
+export declare function detectAsyncExpress(source: string): string | null;
+type Command = string[];
+export interface ToolchainStatus {
+    esbuild: Command | null;
+    javy: Command | null;
+}
+/** Resolve the TS→WASM toolchain without ever hitting the network. */
+export declare function preflightToolchain(): ToolchainStatus;
+/** Full diagnosis for a failed preflight: per-tool status, environment, exact fixes. */
+/** Resolve the active `npx` path (impure: PATH lookup). Returns "not found" if absent. */
+export declare function resolveActiveNpxPath(): string;
+/** True when both tools resolved. */
+export declare function toolchainOk(status: ToolchainStatus): boolean;
+/** Per-tool status + environment, as report lines. Pure (no I/O — pass npxPath in). */
+export declare function formatToolchainReport(status: ToolchainStatus, npxPath: string): string[];
+export declare function buildToolchainErrorMessage(status: ToolchainStatus): string;
+/** True when the gene source has been edited after the WASM was last compiled (#58). */
+export declare function isWasmStale(wasmPath: string, sourcePath: string): boolean;
 export interface JavyCompileResult {
     wasmPath: string;
     bundleSize: number;
@@ -11,7 +41,7 @@ export interface JavyCompileResult {
  */
 export declare function compileTypeScriptToWasm(geneSrcPath: string, outputWasmPath: string): JavyCompileResult;
 /**
- * Check whether the Javy CLI is available.
+ * Check whether the Javy CLI is available (offline check; never hits the registry).
  */
 export declare function isJavyAvailable(): boolean;
 /**
@@ -19,4 +49,5 @@ export declare function isJavyAvailable(): boolean;
  * Returns the path to `index.ts` or `index.js` if found.
  */
 export declare function findGeneSource(geneDir: string): string | null;
+export {};
 //# sourceMappingURL=javy-compiler.d.ts.map

package/dist/utils/javy-compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"javy-compiler.d.ts","sourceRoot":"","sources":["../../src/utils/javy-compiler.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,iBAAiB,CA0CnB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAOzC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM7D"}
+{"version":3,"file":"javy-compiler.d.ts","sourceRoot":"","sources":["../../src/utils/javy-compiler.ts"],"names":[],"mappings":"AAKA,wGAAwG;AACxG,qBAAa,iBAAkB,SAAQ,KAAK;IACjC,IAAI,SAAuB;CACrC;AAED,gGAAgG;AAChG,qBAAa,cAAe,SAAQ,KAAK;IAC9B,IAAI,SAAoB;CAClC;AAUD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKhE;AAED,KAAK,OAAO,GAAG,MAAM,EAAE,CAAC;AA8BxB,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CACtB;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,IAAI,eAAe,CAKpD;AAED,wFAAwF;AACxF,0FAA0F;AAC1F,wBAAgB,oBAAoB,IAAI,MAAM,CAQ7C;AAED,qCAAqC;AACrC,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAE5D;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAOxF;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAS1E;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAOzE;AAcD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,iBAAiB,CA6DnB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM7D"}