@hypersoniclabs/helix-cli 0.1.6 → 0.1.23

package/dist/mesh/surfaceBvh.d.ts

@@ -0,0 +1,13 @@
+export declare function faceNormal(pos: Float32Array, a: number, b: number, c: number): [number, number, number];
+export declare function bboxDiagonal(pos: Float32Array): number;
+export interface Bvh {
+    /** Returns the closest source triangle index (or -1) and fills bary; lastDistSq holds its distance². */
+    closest(x: number, y: number, z: number, nx: number, ny: number, nz: number, bary: {
+        u: number;
+        v: number;
+        w: number;
+    }): number;
+    lastDistSq: number;
+}
+/** Median-split AABB tree over triangles; queries prefer facing-aligned hits when distances are close. */
+export declare function buildBvh(pos: Float32Array, idx: Uint32Array): Bvh;

package/dist/mesh/surfaceBvh.js

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.faceNormal = faceNormal;
+exports.bboxDiagonal = bboxDiagonal;
+exports.buildBvh = buildBvh;
+function faceNormal(pos, a, b, c) {
+    const ux = pos[b * 3] - pos[a * 3], uy = pos[b * 3 + 1] - pos[a * 3 + 1], uz = pos[b * 3 + 2] - pos[a * 3 + 2];
+    const vx = pos[c * 3] - pos[a * 3], vy = pos[c * 3 + 1] - pos[a * 3 + 1], vz = pos[c * 3 + 2] - pos[a * 3 + 2];
+    const x = uy * vz - uz * vy, y = uz * vx - ux * vz, z = ux * vy - uy * vx;
+    const len = Math.hypot(x, y, z) || 1;
+    return [x / len, y / len, z / len];
+}
+function bboxDiagonal(pos) {
+    const min = [Infinity, Infinity, Infinity], max = [-Infinity, -Infinity, -Infinity];
+    for (let v = 0; v < pos.length; v += 3) {
+        for (let k = 0; k < 3; k++) {
+            min[k] = Math.min(min[k], pos[v + k]);
+            max[k] = Math.max(max[k], pos[v + k]);
+        }
+    }
+    return Math.hypot(max[0] - min[0], max[1] - min[1], max[2] - min[2]);
+}
+/** Median-split AABB tree over triangles; queries prefer facing-aligned hits when distances are close. */
+function buildBvh(pos, idx) {
+    const triCount = idx.length / 3;
+    const order = new Uint32Array(triCount);
+    for (let t = 0; t < triCount; t++)
+        order[t] = t;
+    const centroids = new Float32Array(triCount * 3);
+    const normals = new Float32Array(triCount * 3);
+    for (let t = 0; t < triCount; t++) {
+        const a = idx[t * 3], b = idx[t * 3 + 1], c = idx[t * 3 + 2];
+        for (let k = 0; k < 3; k++)
+            centroids[t * 3 + k] = (pos[a * 3 + k] + pos[b * 3 + k] + pos[c * 3 + k]) / 3;
+        const [nx, ny, nz] = faceNormal(pos, a, b, c);
+        normals[t * 3] = nx;
+        normals[t * 3 + 1] = ny;
+        normals[t * 3 + 2] = nz;
+    }
+    const boundsOf = (start, count) => {
+        const b = new Float32Array([Infinity, Infinity, Infinity, -Infinity, -Infinity, -Infinity]);
+        for (let i = start; i < start + count; i++) {
+            const t = order[i];
+            for (const vtx of [idx[t * 3], idx[t * 3 + 1], idx[t * 3 + 2]]) {
+                for (let k = 0; k < 3; k++) {
+                    b[k] = Math.min(b[k], pos[vtx * 3 + k]);
+                    b[k + 3] = Math.max(b[k + 3], pos[vtx * 3 + k]);
+                }
+            }
+        }
+        return b;
+    };
+    const build = (start, count) => {
+        const bounds = boundsOf(start, count);
+        if (count <= 8)
+            return { bounds, start, count, left: null, right: null };
+        let axis = 0, span = -1;
+        for (let k = 0; k < 3; k++) {
+            const s = bounds[k + 3] - bounds[k];
+            if (s > span) {
+                span = s;
+                axis = k;
+            }
+        }
+        const sub = Array.from(order.subarray(start, start + count));
+        sub.sort((p, q) => centroids[p * 3 + axis] - centroids[q * 3 + axis]);
+        order.set(sub, start);
+        const half = count >> 1;
+        return { bounds, start, count, left: build(start, half), right: build(start + half, count - half) };
+    };
+    const root = build(0, triCount);
+    const aabbDistSq = (b, x, y, z) => {
+        const dx = Math.max(b[0] - x, 0, x - b[3]), dy = Math.max(b[1] - y, 0, y - b[4]), dz = Math.max(b[2] - z, 0, z - b[5]);
+        return dx * dx + dy * dy + dz * dz;
+    };
+    const tb = { u: 0, v: 0, w: 0 };
+    const api = {
+        lastDistSq: 0,
+        closest(x, y, z, nx, ny, nz, bary) {
+            // Track the best hit overall AND the best facing-aligned hit; return the aligned one when its
+            // distance is within 1.5x of the absolute best (layered-surface disambiguation).
+            let bestD = Infinity, bestT = -1, bu = 0, bv = 0, bw = 0;
+            let alignD = Infinity, alignT = -1, au = 0, av = 0, aw = 0;
+            const visit = (node) => {
+                // prune at the aligned-acceptance radius (bestD * 1.5²): beyond it a hit can neither win
+                // outright nor qualify as the preferred aligned hit
+                if (aabbDistSq(node.bounds, x, y, z) > bestD * 2.25)
+                    return;
+                if (node.left === null) {
+                    for (let i = node.start; i < node.start + node.count; i++) {
+                        const t = order[i];
+                        const d = closestPointTriangle(pos, idx[t * 3], idx[t * 3 + 1], idx[t * 3 + 2], x, y, z, tb);
+                        if (d < bestD) {
+                            bestD = d;
+                            bestT = t;
+                            bu = tb.u;
+                            bv = tb.v;
+                            bw = tb.w;
+                        }
+                        const dot = normals[t * 3] * nx + normals[t * 3 + 1] * ny + normals[t * 3 + 2] * nz;
+                        if (dot > 0.15 && d < alignD) {
+                            alignD = d;
+                            alignT = t;
+                            au = tb.u;
+                            av = tb.v;
+                            aw = tb.w;
+                        }
+                    }
+                    return;
+                }
+                const dl = aabbDistSq(node.left.bounds, x, y, z), dr = aabbDistSq(node.right.bounds, x, y, z);
+                if (dl < dr) {
+                    visit(node.left);
+                    visit(node.right);
+                }
+                else {
+                    visit(node.right);
+                    visit(node.left);
+                }
+            };
+            visit(root);
+            if (alignT >= 0 && alignD <= bestD * 2.25) {
+                bary.u = au;
+                bary.v = av;
+                bary.w = aw;
+                api.lastDistSq = alignD;
+                return alignT;
+            }
+            bary.u = bu;
+            bary.v = bv;
+            bary.w = bw;
+            api.lastDistSq = bestD;
+            return bestT;
+        },
+    };
+    return api;
+}
+/** Ericson closest-point-on-triangle; fills barycentrics (u=A, v=B, w=C), returns distance². */
+function closestPointTriangle(pos, ia, ib, ic, px, py, pz, bary) {
+    const ax = pos[ia * 3], ay = pos[ia * 3 + 1], az = pos[ia * 3 + 2];
+    const bx = pos[ib * 3], by = pos[ib * 3 + 1], bz = pos[ib * 3 + 2];
+    const cx = pos[ic * 3], cy = pos[ic * 3 + 1], cz = pos[ic * 3 + 2];
+    const abx = bx - ax, aby = by - ay, abz = bz - az;
+    const acx = cx - ax, acy = cy - ay, acz = cz - az;
+    const apx = px - ax, apy = py - ay, apz = pz - az;
+    const d1 = abx * apx + aby * apy + abz * apz;
+    const d2 = acx * apx + acy * apy + acz * apz;
+    let u = 0, v = 0, w = 0;
+    region: {
+        if (d1 <= 0 && d2 <= 0) {
+            u = 1;
+            break region;
+        }
+        const bpx = px - bx, bpy = py - by, bpz = pz - bz;
+        const d3 = abx * bpx + aby * bpy + abz * bpz;
+        const d4 = acx * bpx + acy * bpy + acz * bpz;
+        if (d3 >= 0 && d4 <= d3) {
+            v = 1;
+            break region;
+        }
+        const vc = d1 * d4 - d3 * d2;
+        if (vc <= 0 && d1 >= 0 && d3 <= 0) {
+            v = d1 / (d1 - d3);
+            u = 1 - v;
+            break region;
+        }
+        const cpx = px - cx, cpy = py - cy, cpz = pz - cz;
+        const d5 = abx * cpx + aby * cpy + abz * cpz;
+        const d6 = acx * cpx + acy * cpy + acz * cpz;
+        if (d6 >= 0 && d5 <= d6) {
+            w = 1;
+            break region;
+        }
+        const vb = d5 * d2 - d1 * d6;
+        if (vb <= 0 && d2 >= 0 && d6 <= 0) {
+            w = d2 / (d2 - d6);
+            u = 1 - w;
+            break region;
+        }
+        const va = d3 * d6 - d5 * d4;
+        if (va <= 0 && d4 - d3 >= 0 && d5 - d6 >= 0) {
+            w = (d4 - d3) / (d4 - d3 + (d5 - d6));
+            v = 1 - w;
+            break region;
+        }
+        const denom = 1 / (va + vb + vc);
+        v = vb * denom;
+        w = vc * denom;
+        u = 1 - v - w;
+    }
+    bary.u = u;
+    bary.v = v;
+    bary.w = w;
+    const qx = u * ax + v * bx + w * cx - px, qy = u * ay + v * by + w * cy - py, qz = u * az + v * bz + w * cz - pz;
+    return qx * qx + qy * qy + qz * qz;
+}
+//# sourceMappingURL=surfaceBvh.js.map

package/dist/mesh/surfaceBvh.js.map

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

package/dist/module-validation.d.ts

@@ -0,0 +1,2 @@
+/** Prefix module-scoped validator failures with the authored instance id, not only its array offset. */
+export declare function labelModuleValidationErrors(errors: readonly string[], manifestValue: unknown): string[];

package/dist/module-validation.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.labelModuleValidationErrors = labelModuleValidationErrors;
+function objectRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+/** Prefix module-scoped validator failures with the authored instance id, not only its array offset. */
+function labelModuleValidationErrors(errors, manifestValue) {
+    const multiplayer = objectRecord(objectRecord(manifestValue).multiplayer);
+    const modules = Array.isArray(multiplayer.modules) ? multiplayer.modules : [];
+    return errors.map((error) => {
+        const match = /multiplayer\.modules(?:\[([0-9]+)\]|\.([0-9]+))/.exec(error);
+        if (!match)
+            return error;
+        const index = Number(match[1] ?? match[2]);
+        const id = objectRecord(modules[index]).id;
+        return typeof id === 'string' && id.length > 0
+            ? `module "${id}": ${error}`
+            : error;
+    });
+}
+//# sourceMappingURL=module-validation.js.map

package/dist/module-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-validation.js","sourceRoot":"","sources":["../src/module-validation.ts"],"names":[],"mappings":";;AASA,kEAeC;AAtBD,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAE,KAAoB;QACvB,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,wGAAwG;AACxG,SAAgB,2BAA2B,CACzC,MAAyB,EACzB,aAAsB;IAEtB,MAAM,WAAW,GAAG,YAAY,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,WAAW,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1B,MAAM,KAAK,GAAG,iDAAiD,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5E,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,OAAO,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAC5C,CAAC,CAAC,WAAW,EAAE,MAAM,KAAK,EAAE;YAC5B,CAAC,CAAC,KAAK,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/money.d.ts

@@ -0,0 +1,183 @@
+import { CliCredentials } from './config';
+/** LIX is a decimal amount (the wallet column is numeric(19,4)) — never minor units. */
+export declare const LIX_DP = 4;
+export declare const roundLix: (value: number) => number;
+/** Render a LIX amount for humans: trim trailing zeros but never lie about precision. */
+export declare function formatLix(value: number): string;
+export type LixHold = {
+    reservationId?: string;
+    jobId?: string | null;
+    action?: string;
+    label?: string;
+    lix: number;
+    reservedAt?: string;
+    holdUntil?: string;
+};
+export type LixBalance = {
+    currency: string;
+    available: number;
+    held: number;
+    total: number;
+    breakdown?: {
+        withdrawable?: number;
+        nonWithdrawable?: number;
+    };
+    holds: LixHold[];
+    /** Which endpoint answered — the dedicated billing route, or the raw wallet fallback. */
+    source: 'lix-billing' | 'wallet';
+};
+/**
+ * Read the caller's LIX balance.
+ *
+ * Prefers `GET /api/v1/lix-billing/balance`, which reports available/held/total and itemises open
+ * holds. Falls back to the raw economy wallet (`GET /api/v1/wallet/me`) on 404 so the command works
+ * against deployments where the billing route has not landed yet — and says which one answered,
+ * because the wallet has no notion of `held` and reporting 0 held as if it were measured would hide
+ * exactly the stranded money this command exists to reveal.
+ */
+export declare function getLixBalance(creds: CliCredentials): Promise<LixBalance>;
+export declare function formatBalance(balance: LixBalance): string;
+/**
+ * How a component's price relates to what you can actually be charged:
+ *   exact    — the charge IS this number.
+ *   ceiling  — the charge is at most this number (`maxLix === lix`).
+ *   estimate — the charge can land either side; `maxLix` is the real cap.
+ *
+ * `estimate` exists because `ceiling` used to be applied to music, which is billed on the duration
+ * the provider ACCEPTS — that can exceed the duration requested, so the authorized cap sits above
+ * the quote. The charge was never uncapped; the label oversold it.
+ */
+export type EstimateBasis = 'exact' | 'ceiling' | 'estimate';
+export type QuoteComponent = {
+    stage: string;
+    action?: string;
+    /** Server-owned display name. Never map action→label CLI-side; that map has already drifted once. */
+    label?: string;
+    lix?: number;
+    spark?: number;
+    /** The most this component can be charged. Equals `lix` for exact/ceiling. */
+    maxLix?: number;
+    priceType?: 'base' | 'premium' | string;
+    estimateBasis?: EstimateBasis;
+};
+export type GenerationQuote = {
+    totalLix: number;
+    baseLix: number;
+    premiumLix: number;
+    /**
+     * The most this job can be charged — the number a spend guard must compare against. Guarding
+     * `totalLix` lets someone approve a bound the charge is permitted to exceed.
+     */
+    maxLix: number;
+    components: QuoteComponent[];
+    quoteToken?: string;
+    quoteId?: string;
+    expiresAt?: string;
+    configVersion?: string;
+    estimateBasis: EstimateBasis;
+};
+type QuoteResponse = {
+    lix?: number;
+    spark?: number;
+    maxLix?: number;
+    pricing?: {
+        maxLix?: number;
+        baseLix?: number;
+        premiumLix?: number;
+        totalLix?: number;
+        baseSpark?: number;
+        premiumSpark?: number;
+        totalSpark?: number;
+    };
+    components?: QuoteComponent[];
+    quoteToken?: string;
+    quoteId?: string;
+    expiresAt?: string;
+    configVersion?: string;
+    estimateBasis?: EstimateBasis;
+};
+export declare function normalizeQuote(res: QuoteResponse): GenerationQuote;
+/**
+ * Price a generation BEFORE running it. The request body is the same DTO the generation route
+ * takes, deliberately: it prices the real request rather than a parallel model of it.
+ */
+export declare function quoteGeneration(creds: CliCredentials, input: unknown): Promise<GenerationQuote>;
+export declare function formatQuote(quote: GenerationQuote, balance?: LixBalance | null): string;
+/**
+ * What a finished job actually cost, in LIX, from either route.
+ *
+ * Dreamer reports `lixSpentTotal`. The asset pipeline reported `units` and never said LIX, so
+ * nothing on that receipt stated the currency — and `units` IS LIX: the backend computes it as
+ * `Number(job.lixSpentTotal || '0')`, same number, different name, no conversion. Read the
+ * canonical field, fall back to the alias, and present one name.
+ */
+export declare function receiptLix(job: {
+    lixSpentTotal?: number | string;
+    units?: number;
+    sparkSpentTotal?: number;
+}): number | null;
+/** One consistent cost line for both generation routes. */
+export declare function formatReceipt(job: {
+    lixSpentTotal?: number | string;
+    units?: number;
+    sparkSpentTotal?: number;
+    providerCostUsd?: number;
+}): string | null;
+/**
+ * How long this job has been working, and what happens if it never finishes.
+ *
+ * A cold end-to-end run watched a music generation sit at `stage: "provider"` with LIX held and
+ * `updatedAt` frozen. Nothing in any payload distinguished "the provider is still composing" from
+ * "the process that was calling the provider is gone", there was no stated deadline, and
+ * `recovery.actions` was empty — so after fifteen minutes the run started the duplicate job the
+ * tools explicitly tell you not to start. (The duplicate returned in ten seconds; the original
+ * later surfaced as failed with no charge, i.e. the platform HAD recovered it — silently, with no
+ * way to know that was coming.)
+ *
+ * The platform's actual contract: an interrupted paid provider call is never repeated, and its
+ * hold is released by bounded automatic reconciliation. That is a good contract. It was just
+ * invisible. Say it, with the elapsed time, so waiting is an informed decision rather than a guess.
+ */
+export declare function formatWaitState(job: {
+    status?: string;
+    currentStage?: string;
+    stages?: {
+        name: string;
+        status: string;
+        startedAt?: string | null;
+    }[];
+    updatedAt?: string;
+    openHoldLix?: number;
+}, now?: Date): string | null;
+export type JobSummary = {
+    id: string;
+    jobId?: string;
+    status: string;
+    kind?: string;
+    title?: string | null;
+    lixSpentTotal?: number | string;
+    units?: number;
+    openHoldLix?: number;
+    recoverable?: boolean;
+    awaitingApproval?: {
+        gate: string;
+        options?: string[];
+    } | null;
+    error?: string | null;
+    publishedItemId?: string | null;
+    createdAt?: string;
+};
+export type JobState = 'all' | 'unfinished' | 'failed' | 'published' | 'awaiting_approval';
+export declare function listJobs(creds: CliCredentials, query?: {
+    limit?: number;
+    offset?: number;
+    state?: JobState;
+}): Promise<{
+    jobs: JobSummary[];
+    total: number | null;
+}>;
+export declare function formatJobs(result: {
+    jobs: JobSummary[];
+    total: number | null;
+}): string;
+export {};