@hypersoniclabs/helix-cli 0.1.7 → 0.1.24-helix3.438

package/dist/pack/validate.js

@@ -0,0 +1,317 @@
+"use strict";
+// `helix pack validate` — the whole locomotion-pack gate, offline: the clip-meta schema, one GLB per entry,
+// the measured-vs-declared duration, a skeleton precheck, and the pack rules. Collect-all, like the add-on
+// gate it stands in for — a pack is 38 clips and reporting the first bad one is 38 round trips.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.packPinsPath = exports.DURATION_TOLERANCE_S = exports.PINS_FILE = exports.CLIP_META_FILE = void 0;
+exports.sourceDigest = sourceDigest;
+exports.readPackPins = readPackPins;
+exports.buildPackFits = buildPackFits;
+exports.buildPackOps = buildPackOps;
+exports.validateLocomotionPack = validateLocomotionPack;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const glb_1 = require("../glb");
+const emoteRules_1 = require("../itemDef/emoteRules");
+const locomotionReference_1 = require("./locomotionReference");
+/**
+ * Where the pack's meta and its recorded pins live, pack-relative. The pins ride BESIDE the meta rather than
+ * inside it: clip-meta.json is authored (and re-emitted by the pipeline), the pin ledger is publish output.
+ */
+exports.CLIP_META_FILE = 'anims/clip-meta.json';
+exports.PINS_FILE = 'anims/pins.json';
+/** How far the measured GLB length may sit from the declared `duration`, seconds. */
+exports.DURATION_TOLERANCE_S = 0.05;
+/** The pointer grammar the gate reads a clip op's `at` with — a bare name outside it can never be installed. */
+const BARE_NAME_RE = /^[A-Za-z0-9_]+$/;
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** The digest a re-run compares against to decide whether a clip still needs uploading. */
+function sourceDigest(bytes) {
+    return (0, node_crypto_1.createHash)('sha256').update(bytes).digest('hex');
+}
+const packPinsPath = (dir) => (0, node_path_1.join)((0, node_path_1.resolve)(dir), exports.PINS_FILE);
+exports.packPinsPath = packPinsPath;
+/** Read `anims/pins.json`, or an empty ledger when the pack has never been published. */
+function readPackPins(dir) {
+    const path = (0, exports.packPinsPath)(dir);
+    if (!(0, node_fs_1.existsSync)(path))
+        return { version: 1, clips: {} };
+    let parsed;
+    try {
+        parsed = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf8'));
+    }
+    catch (err) {
+        throw new Error(`${exports.PINS_FILE} is not valid JSON — delete it to re-upload every clip (${err instanceof Error ? err.message : String(err)})`);
+    }
+    const clips = isRecord(parsed) && isRecord(parsed.clips) ? parsed.clips : {};
+    const out = { version: 1, clips: {} };
+    for (const [name, entry] of Object.entries(clips)) {
+        if (!isRecord(entry))
+            continue;
+        if (typeof entry.assetId !== 'string' || typeof entry.version !== 'number' || typeof entry.checksumSha256 !== 'string')
+            continue;
+        if (typeof entry.sourceSha256 !== 'string' || typeof entry.durationSeconds !== 'number')
+            continue;
+        out.clips[name] = {
+            assetId: entry.assetId,
+            version: entry.version,
+            checksumSha256: entry.checksumSha256,
+            sourceSha256: entry.sourceSha256,
+            durationSeconds: entry.durationSeconds,
+            uploadedAt: typeof entry.uploadedAt === 'string' ? entry.uploadedAt : '',
+        };
+    }
+    return out;
+}
+/** The compatibility contract a locomotion pack declares. The CLI's assertFits demands all four arrays. */
+function buildPackFits(clips) {
+    return {
+        slotType: locomotionReference_1.LOCOMOTION_SLOT_TYPE,
+        requires: {
+            sockets: [],
+            paths: [],
+            nodes: [],
+            pointers: clips.map((clip) => `/clips/${clip.bareName}`),
+            skeleton: locomotionReference_1.LOCOMOTION_SKELETON,
+        },
+    };
+}
+/**
+ * One `patch`/`set` op per clip — the pack's whole content, since there is no mesh behind it. Throws on a clip
+ * with no usable pin: an op naming nothing is a listing with a price on it.
+ */
+function buildPackOps(clips) {
+    return clips.map((clip) => {
+        if (clip.pin === null) {
+            throw new Error(`"${clip.name}" has no recorded pin — its clip must reach the Vault before the add-on names it`);
+        }
+        return {
+            v: 'patch',
+            op: 'set',
+            at: `/clips/${clip.bareName}`,
+            value: {
+                assetId: clip.pin.assetId,
+                version: clip.pin.version,
+                checksumSha256: clip.pin.checksumSha256,
+                strideSpeed: clip.strideSpeed,
+                loop: clip.loop,
+                ...(clip.direction === undefined ? {} : { direction: clip.direction }),
+            },
+        };
+    });
+}
+/** Why this stride may not ship for this clip name, or null when it may. The GATE's posture: refuse, never clamp. */
+function strideRefusal(bareName, strideSpeed, reference) {
+    if (reference === null || reference.strideSpeed === null) {
+        if (strideSpeed === null)
+            return null;
+        return `"${bareName}" does not travel in the platform set, so its strideSpeed must be null (got ${(0, locomotionReference_1.speed)(strideSpeed)}) ` +
+            '— the runtime plays it on the spot.';
+    }
+    if (strideSpeed === null) {
+        return `"${bareName}" travels in the platform set (${(0, locomotionReference_1.speed)(reference.strideSpeed)}), so it must declare its own ` +
+            'measured strideSpeed — without one the feet slide.';
+    }
+    const min = reference.strideSpeed * locomotionReference_1.PACK_STRIDE_BAND.minRatio;
+    const max = reference.strideSpeed * locomotionReference_1.PACK_STRIDE_BAND.maxRatio;
+    if (strideSpeed < min || strideSpeed > max) {
+        const against = reference.referenceName === bareName
+            ? `the platform ${(0, locomotionReference_1.speed)(reference.strideSpeed)}`
+            : `the platform "${reference.referenceName}" (${(0, locomotionReference_1.speed)(reference.strideSpeed)}), which its ring is measured against`;
+        return `"${bareName}": ${(0, locomotionReference_1.speed)(strideSpeed)} is outside ${(0, locomotionReference_1.speed)(min)}–${(0, locomotionReference_1.speed)(max)} ` +
+            `(${locomotionReference_1.PACK_STRIDE_BAND.minRatio}–${locomotionReference_1.PACK_STRIDE_BAND.maxRatio}× ${against}).`;
+    }
+    return null;
+}
+/** walk < run < sprint, over the gaits THIS pack replaces. */
+function ladderRefusals(gaits) {
+    const errors = [];
+    let slower = null;
+    for (const gait of locomotionReference_1.GAIT_LADDER) {
+        const declared = gaits.get(gait);
+        if (declared === undefined)
+            continue;
+        if (slower !== null && declared <= slower.strideSpeed) {
+            errors.push(`"${gait}" (${(0, locomotionReference_1.speed)(declared)}) must travel faster than "${slower.gait}" (${(0, locomotionReference_1.speed)(slower.strideSpeed)}).`);
+        }
+        slower = { gait, strideSpeed: declared };
+    }
+    return errors;
+}
+/** The schema pass over one clip-meta entry. Returns the clip when every field is usable, else null. */
+function readEntry(entry, where, errors) {
+    if (!isRecord(entry)) {
+        errors.push(`${where} is not an object — clip-meta.json is an array of { name, loop, duration, strideSpeed } entries`);
+        return null;
+    }
+    let fatal = false;
+    const name = entry.name;
+    if (typeof name !== 'string' || !name.startsWith(locomotionReference_1.LOCOMOTION_NAME_PREFIX)) {
+        // The runtime SKIPS a foreign name silently (other systems may cohabit the file); in a pack it would ship
+        // a clip nobody ever plays, so this lane refuses it instead.
+        errors.push(`${where}.name must be a "${locomotionReference_1.LOCOMOTION_NAME_PREFIX}<clip>" string (got ${JSON.stringify(name)})`);
+        fatal = true;
+    }
+    if (typeof entry.loop !== 'boolean') {
+        errors.push(`${where}.loop must be a boolean — true cycles, false plays once (got ${JSON.stringify(entry.loop)})`);
+        fatal = true;
+    }
+    if (typeof entry.duration !== 'number' || !Number.isFinite(entry.duration) || entry.duration <= 0) {
+        errors.push(`${where}.duration must be the clip's length in seconds, a finite number > 0 (got ${JSON.stringify(entry.duration)})`);
+        fatal = true;
+    }
+    if (entry.strideSpeed !== null && (typeof entry.strideSpeed !== 'number' || !Number.isFinite(entry.strideSpeed))) {
+        errors.push(`${where}.strideSpeed must be the measured metres/second, or null for a clip that does not travel (got ${JSON.stringify(entry.strideSpeed)})`);
+        fatal = true;
+    }
+    if (entry.direction !== undefined && (typeof entry.direction !== 'number' || !Number.isFinite(entry.direction))) {
+        errors.push(`${where}.direction, when present, must be the degrees off forward as a number (got ${JSON.stringify(entry.direction)})`);
+        fatal = true;
+    }
+    if (fatal)
+        return null;
+    const bareName = name.slice(locomotionReference_1.LOCOMOTION_NAME_PREFIX.length);
+    if (!BARE_NAME_RE.test(bareName)) {
+        errors.push(`${where}.name "${name}" — the clip pointer accepts letters, digits and underscores after "${locomotionReference_1.LOCOMOTION_NAME_PREFIX}"`);
+        return null;
+    }
+    if (!(0, locomotionReference_1.isGrantedClipName)(bareName)) {
+        errors.push(`${where}.name "${name}" is outside the slot's gait-only vocabulary — deaths, get-ups, sit/lie and hit reactions stay platform-owned.`);
+        return null;
+    }
+    return {
+        name: name,
+        bareName,
+        loop: entry.loop,
+        duration: entry.duration,
+        strideSpeed: entry.strideSpeed,
+        ...(entry.direction === undefined ? {} : { direction: entry.direction }),
+    };
+}
+/**
+ * Validate a pack directory offline. Everything the backend's clip-set gate refuses is refused here too, plus
+ * the two things it never sees: the local GLBs, and whether the declared duration matches their bytes.
+ */
+function validateLocomotionPack(dir) {
+    const root = (0, node_path_1.resolve)(dir);
+    const out = { dir: root, errors: [], warnings: [], clips: [], pinned: false };
+    const metaPath = (0, node_path_1.join)(root, exports.CLIP_META_FILE);
+    if (!(0, node_fs_1.existsSync)(metaPath)) {
+        out.errors.push(`${exports.CLIP_META_FILE} not found (expected at ${metaPath}) — scaffold one with \`helix pack scaffold ${dir}\``);
+        return out;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse((0, node_fs_1.readFileSync)(metaPath, 'utf8'));
+    }
+    catch (err) {
+        out.errors.push(`${exports.CLIP_META_FILE}: invalid JSON — ${err instanceof Error ? err.message : String(err)}`);
+        return out;
+    }
+    if (!Array.isArray(parsed)) {
+        out.errors.push(`${exports.CLIP_META_FILE} must be a JSON ARRAY of clip entries — the loader rejects the whole pack otherwise`);
+        return out;
+    }
+    if (parsed.length === 0) {
+        out.errors.push(`${exports.CLIP_META_FILE} is empty — a pack's clips are its content, so it must carry at least one`);
+        return out;
+    }
+    let pins;
+    try {
+        pins = readPackPins(root);
+    }
+    catch (err) {
+        out.errors.push(err instanceof Error ? err.message : String(err));
+        pins = { version: 1, clips: {} };
+    }
+    const seen = new Set();
+    const gaits = new Map();
+    for (const [index, entry] of parsed.entries()) {
+        const where = `${exports.CLIP_META_FILE}[${index}]`;
+        const read = readEntry(entry, where, out.errors);
+        if (read === null)
+            continue;
+        if (seen.has(read.name)) {
+            out.errors.push(`${where}.name "${read.name}" appears twice — one entry installs one clip`);
+            continue;
+        }
+        seen.add(read.name);
+        const ref = `anims/${read.name}.glb`;
+        const file = (0, node_path_1.join)(root, 'anims', `${read.name}.glb`);
+        const clip = { ...read, ref, file, measuredS: null, pin: null };
+        if (!(0, node_fs_1.existsSync)(file)) {
+            out.errors.push(`${ref} not found — the GLB file name must equal the entry's name exactly, including the "${locomotionReference_1.LOCOMOTION_NAME_PREFIX}" prefix`);
+        }
+        else {
+            const bytes = (0, node_fs_1.readFileSync)(file);
+            const measured = (0, emoteRules_1.measureEmoteClip)(bytes, ref);
+            out.errors.push(...measured.errors);
+            if (measured.animationCount > 1) {
+                out.errors.push(`${ref} carries ${measured.animationCount} animations — a pack clip is exactly one, and the loader would take the first`);
+            }
+            clip.measuredS = measured.durationS;
+            if (measured.durationS === null) {
+                if (measured.errors.length === 0) {
+                    out.errors.push(`${ref} declares no sampler timings, so its duration cannot be measured — the pinned version needs one and the gate refuses a pin without it`);
+                }
+            }
+            else if (Math.abs(measured.durationS - clip.duration) > exports.DURATION_TOLERANCE_S) {
+                out.errors.push(`${ref} runs ${measured.durationS.toFixed(3)}s but ${where}.duration declares ${clip.duration}s — they must match within ${exports.DURATION_TOLERANCE_S}s.`);
+            }
+            // Skeleton precheck: an animation-only GLB names its joints through its channels, so an empty list means
+            // nothing in this file targets a bone at all.
+            try {
+                if ((0, glb_1.summarizeGlb)(bytes).boneNames.length === 0) {
+                    out.errors.push(`${ref} animates no named bone — clips must target the canonical ${locomotionReference_1.LOCOMOTION_SKELETON} bone names`);
+                }
+            }
+            catch (err) {
+                out.errors.push(`${ref} could not be parsed as a binary glTF — ${err instanceof Error ? err.message : String(err)}`);
+            }
+            const recorded = pins.clips[read.name];
+            if (recorded !== undefined && recorded.sourceSha256 === sourceDigest(bytes))
+                clip.pin = recorded;
+        }
+        // THE PACK RULES, in the publish gate's REFUSE posture — the engine CLAMPS an out-of-band stride so a
+        // bought pack keeps playing, this refuses it so a pack that only looks right once corrected never ships.
+        const refusal = strideRefusal(clip.bareName, clip.strideSpeed, (0, locomotionReference_1.strideReferenceFor)(clip.bareName));
+        if (refusal !== null)
+            out.errors.push(`${where}: ${refusal}`);
+        else if (clip.strideSpeed !== null && locomotionReference_1.GAIT_LADDER.includes(clip.bareName)) {
+            gaits.set(clip.bareName, clip.strideSpeed);
+        }
+        // A ring sibling with no `direction` still LOADS — it is registered and never joins the ring, so it is
+        // bought and never seen. That is a warning, not a refusal: the pack is otherwise valid.
+        const suffix = (0, locomotionReference_1.ringSuffixOf)(clip.bareName);
+        if (suffix !== null && clip.direction === undefined) {
+            out.warnings.push(`${where} "${clip.name}" is a ring member with no "direction" — it would load but never join the ring ` +
+                `(expected ${locomotionReference_1.RING_DIRECTION_DEG[suffix]} for "${suffix}")`);
+        }
+        else if (suffix !== null && clip.direction !== locomotionReference_1.RING_DIRECTION_DEG[suffix]) {
+            out.warnings.push(`${where} "${clip.name}" declares direction ${clip.direction} — the "${suffix}" ring position is ` +
+                `${locomotionReference_1.RING_DIRECTION_DEG[suffix]}, and the blend space interpolates from the authored angle`);
+        }
+        out.clips.push(clip);
+    }
+    out.errors.push(...ladderRefusals(gaits));
+    // Anything in anims/ nothing references never ships — the manifest is built from clip-meta.json alone.
+    const animsDir = (0, node_path_1.join)(root, 'anims');
+    if ((0, node_fs_1.existsSync)(animsDir) && (0, node_fs_1.statSync)(animsDir).isDirectory()) {
+        for (const entry of (0, node_fs_1.readdirSync)(animsDir)) {
+            if (!entry.toLowerCase().endsWith('.glb'))
+                continue;
+            if (seen.has(entry.slice(0, -4)))
+                continue;
+            out.warnings.push(`anims/${entry} has no clip-meta.json entry — it would not be uploaded or served`);
+        }
+    }
+    if (out.clips.length === 0 && out.errors.length === 0) {
+        out.errors.push(`${exports.CLIP_META_FILE} declares no usable clip — a pack must pin at least one`);
+    }
+    out.pinned = out.clips.length > 0 && out.clips.every((clip) => clip.pin !== null);
+    out.errors = [...new Set(out.errors)];
+    out.warnings = [...new Set(out.warnings)];
+    return out;
+}
+//# sourceMappingURL=validate.js.map

package/dist/pack/validate.js.map

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

package/dist/package.d.ts

@@ -1,6 +1,19 @@
-import { type HelixPackageEnvelope } from '@hypersoniclabs/helix-manifest';
+import { type HelixEventDecl, type HelixPackageEnvelope } from '@hypersoniclabs/helix-manifest';
 import { type AbilityValidator } from './ability';
 import type { BundleFile } from './bundle';
+/**
+ * The world-event contract a package declares for its `from: "world"` imports, read from
+ * `interactable.json` → `interface.worldEvents` (the package-owned free-form field in v1; same shape as
+ * a world's `multiplayer.events`). A package that imports from the world without declaring the
+ * contract cannot be validated in isolation and is refused with the missing key named, instead of
+ * the misleading "world does not export" the bare validator produces (helix-creator-cli#122).
+ */
+export declare function interactableWorldEventContract(manifest: {
+    interface: Record<string, unknown>;
+}, fragment: unknown): {
+    worldEvents: Record<string, HelixEventDecl> | undefined;
+    errors: string[];
+};
 export type PackageBundleCheck = {
     kind: string | null;
     envelope: HelixPackageEnvelope | null;

package/dist/package.js

@@ -1,10 +1,42 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.interactableWorldEventContract = interactableWorldEventContract;
 exports.checkPackageBundle = checkPackageBundle;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
 const ability_1 = require("./ability");
+const interactable_1 = require("./interactable");
+/**
+ * The world-event contract a package declares for its `from: "world"` imports, read from
+ * `interactable.json` → `interface.worldEvents` (the package-owned free-form field in v1; same shape as
+ * a world's `multiplayer.events`). A package that imports from the world without declaring the
+ * contract cannot be validated in isolation and is refused with the missing key named, instead of
+ * the misleading "world does not export" the bare validator produces (helix-creator-cli#122).
+ */
+function interactableWorldEventContract(manifest, fragment) {
+    const declared = manifest.interface?.worldEvents;
+    const isRecord = declared !== null && typeof declared === 'object' && !Array.isArray(declared);
+    const imported = [...new Set((0, interactable_1.worldImportsOf)(fragment).map((entry) => entry.event))];
+    if (!imported.length) {
+        return { worldEvents: isRecord ? declared : undefined, errors: [] };
+    }
+    if (!isRecord) {
+        return {
+            worldEvents: undefined,
+            errors: [
+                `server fragment imports ${imported.length} event(s) from the world (${imported.join(', ')}) but interactable.json interface.worldEvents does not declare their contract; declare each imported event and its payload there`,
+            ],
+        };
+    }
+    const undeclared = imported.filter((event) => !(event in declared));
+    return {
+        worldEvents: declared,
+        errors: undeclared.length
+            ? [`interactable.json interface.worldEvents does not declare imported world event(s): ${undeclared.join(', ')}`]
+            : [],
+    };
+}
 const IGNORED_DIRS = new Set(['node_modules', '.git', '.vscode', '.idea']);
 function walk(dir, root, out) {
     for (const name of (0, node_fs_1.readdirSync)(dir)) {
@@ -20,11 +52,10 @@ function walk(dir, root, out) {
         }
     }
 }
-// Detects a non-world bundle's kind and builds its platform envelope: ability
-// bundles carry ability.json (the CLI derives the envelope and sends the payload
-// as the discovery documentation); system/asset-pack bundles carry helix.json,
-// which IS the envelope. World bundles are refused with a hint. Same caps and
-// rules the server enforces at publish, via @hypersoniclabs/helix-manifest.
+// Detects a non-world bundle's kind and builds its platform envelope. Ability
+// and interactable bundles carry kind-specific manifests; system/asset-pack
+// bundles carry helix.json, which IS the envelope. World bundles are refused.
+// The same shared contract runs here and in the backend publish gate.
 function checkPackageBundle(root, validator) {
     const errors = [];
     const files = [];
@@ -38,8 +69,76 @@ function checkPackageBundle(root, validator) {
     let envelope = null;
     let payload = null;
     const abilityPath = (0, node_path_1.join)(root, 'ability.json');
+    const interactablePath = (0, node_path_1.join)(root, 'interactable.json');
     const helixPath = (0, node_path_1.join)(root, 'helix.json');
-    if ((0, node_fs_1.existsSync)(abilityPath)) {
+    if ((0, node_fs_1.existsSync)(interactablePath)) {
+        let parsed = null;
+        try {
+            parsed = JSON.parse((0, node_fs_1.readFileSync)(interactablePath, 'utf8'));
+        }
+        catch (err) {
+            errors.push(`interactable.json is not valid JSON: ${err instanceof Error ? err.message : err}`);
+        }
+        if (parsed !== null) {
+            const manifestResult = (0, helix_manifest_1.validateInteractablePackageManifest)(parsed);
+            if (!manifestResult.valid) {
+                errors.push(...manifestResult.errors);
+            }
+            else {
+                const manifest = manifestResult.manifest;
+                payload = manifest;
+                const fragmentPath = (0, node_path_1.join)(root, manifest.server.fragment);
+                let fragment = null;
+                if (!(0, node_fs_1.existsSync)(fragmentPath)) {
+                    errors.push(`server fragment "${manifest.server.fragment}" does not exist in the bundle`);
+                }
+                else {
+                    try {
+                        fragment = JSON.parse((0, node_fs_1.readFileSync)(fragmentPath, 'utf8'));
+                    }
+                    catch (err) {
+                        errors.push(`${manifest.server.fragment} is not valid JSON: ${err instanceof Error ? err.message : err}`);
+                    }
+                }
+                if (fragment !== null) {
+                    const contract = interactableWorldEventContract(manifest, fragment);
+                    if (contract.errors.length) {
+                        // The contract error is the actionable one; a bare fragment check would only add
+                        // "world does not export …" noise for every import it cannot resolve.
+                        errors.push(...contract.errors);
+                    }
+                    else {
+                        const fragmentResult = (0, helix_manifest_1.validateInteractableServerFragment)(fragment, {
+                            worldEvents: contract.worldEvents,
+                        });
+                        if (!fragmentResult.valid) {
+                            errors.push(...fragmentResult.errors);
+                        }
+                        else {
+                            errors.push(...(0, helix_manifest_1.compareInteractableBudget)(manifest.budget, fragmentResult.budget));
+                        }
+                    }
+                }
+                const candidate = {
+                    envelopeVersion: '1',
+                    kind: 'interactable',
+                    slug: manifest.id,
+                    version: manifest.version,
+                    title: manifest.title,
+                    description: manifest.description,
+                    entry: manifest.client.entry,
+                };
+                const envelopeResult = (0, helix_manifest_1.validatePackageEnvelope)(candidate);
+                if (!envelopeResult.valid)
+                    errors.push(...envelopeResult.errors);
+                else {
+                    envelope = envelopeResult.envelope;
+                    kind = 'interactable';
+                }
+            }
+        }
+    }
+    else if ((0, node_fs_1.existsSync)(abilityPath)) {
         const check = (0, ability_1.checkAbilityBundle)(root, validator);
         if (check.errors.length || check.manifest === null) {
             errors.push(...check.errors);
@@ -107,7 +206,7 @@ function checkPackageBundle(root, validator) {
         }
     }
     else {
-        errors.push('no ability.json or helix.json at the bundle root — is this the built bundle directory (dist/)?');
+        errors.push('no interactable.json, ability.json, or helix.json at the bundle root — is this the built bundle directory (dist/)?');
     }
     if (kind) {
         const limits = (0, helix_manifest_1.bundleLimitsForKind)(kind);

package/dist/package.js.map

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