@elizaos/shared 2.0.0-beta.1 → 2.0.11-beta.7

package/lifeops-normalize/service-normalize.js

@@ -0,0 +1,205 @@
+/**
+ * LifeOps normalize/validation primitives (runtime-level, pure).
+ *
+ * Input normalization + validation helpers for the personal-assistant
+ * pipelines: enum coercion, string/number/boolean/ISO/timezone/phone
+ * normalization, and the owner-entity id derivation. Depends only on
+ * `@elizaos/core`, the LifeOps contract types/constants, and the time-zone +
+ * service-error primitives (all in `@elizaos/shared`). No DB, no plugin
+ * imports. Consumed by `@elizaos/plugin-personal-assistant`, which keeps a thin
+ * re-export shim at `lifeops/service-normalize.ts` for historical import paths.
+ */
+import { stringToUuid } from "@elizaos/core";
+import { LIFEOPS_CONTEXT_POLICIES, LIFEOPS_DOMAINS, LIFEOPS_PRIVACY_CLASSES, LIFEOPS_REMINDER_URGENCY_LEVELS, LIFEOPS_SUBJECT_TYPES, LIFEOPS_VISIBILITY_SCOPES, } from "../contracts/personal-assistant.js";
+import { LIFEOPS_TIME_ZONE_ALIASES } from "../lifeops-constants/index.js";
+import { LifeOpsServiceError } from "./service-error.js";
+import { isValidTimeZone, resolveDefaultTimeZone } from "./time-zone.js";
+export function lifeOpsErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function fail(status, message, code) {
+    throw new LifeOpsServiceError(status, message, code);
+}
+export function defaultOwnerEntityId(runtime) {
+    return stringToUuid(`${requireAgentId(runtime)}-admin-entity`);
+}
+export function normalizeLifeOpsDomain(value, fallback) {
+    return normalizeEnumValue(value, "ownership.domain", LIFEOPS_DOMAINS, fallback);
+}
+export function normalizeLifeOpsSubjectType(value, fallback) {
+    return normalizeEnumValue(value, "ownership.subjectType", LIFEOPS_SUBJECT_TYPES, fallback);
+}
+export function normalizeLifeOpsVisibilityScope(value, fallback) {
+    return normalizeEnumValue(value, "ownership.visibilityScope", LIFEOPS_VISIBILITY_SCOPES, fallback);
+}
+export function normalizeLifeOpsContextPolicy(value, fallback) {
+    return normalizeEnumValue(value, "ownership.contextPolicy", LIFEOPS_CONTEXT_POLICIES, fallback);
+}
+export function requireAgentId(runtime) {
+    const agentId = runtime.agentId;
+    if (typeof agentId !== "string" || agentId.trim().length === 0) {
+        fail(500, "agent runtime is missing agentId");
+    }
+    return agentId;
+}
+export function requireNonEmptyString(value, field) {
+    if (typeof value !== "string") {
+        fail(400, `${field} must be a string`);
+    }
+    const normalized = value.trim();
+    if (normalized.length === 0) {
+        fail(400, `${field} is required`);
+    }
+    return normalized;
+}
+export function normalizeOptionalString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const normalized = value.trim();
+    return normalized.length > 0 ? normalized : undefined;
+}
+export function normalizeOptionalBoolean(value, field) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "string") {
+        const normalized = value.trim().toLowerCase();
+        if (normalized === "true" || normalized === "1") {
+            return true;
+        }
+        if (normalized === "false" || normalized === "0") {
+            return false;
+        }
+    }
+    fail(400, `${field} must be a boolean`);
+}
+export function normalizeIsoString(value, field) {
+    const text = requireNonEmptyString(value, field);
+    const parsed = Date.parse(text);
+    if (!Number.isFinite(parsed)) {
+        fail(400, `${field} must be a valid ISO datetime`);
+    }
+    return new Date(parsed).toISOString();
+}
+export function normalizeOptionalIsoString(value, field) {
+    if (value === undefined || value === null || value === "") {
+        return undefined;
+    }
+    return normalizeIsoString(value, field);
+}
+export function normalizeFiniteNumber(value, field) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === "string" && value.trim().length > 0) {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed)) {
+            return parsed;
+        }
+    }
+    fail(400, `${field} must be a finite number`);
+}
+export function normalizeOptionalMinutes(value, field) {
+    if (value === null || value === undefined || value === "")
+        return undefined;
+    const minutes = Math.trunc(normalizeFiniteNumber(value, field));
+    if (minutes < 0) {
+        fail(400, `${field} must be zero or greater`);
+    }
+    return minutes;
+}
+export function normalizePositiveInteger(value, field) {
+    const number = Math.trunc(normalizeFiniteNumber(value, field));
+    if (number <= 0) {
+        fail(400, `${field} must be greater than zero`);
+    }
+    return number;
+}
+export function normalizeOptionalNonNegativeInteger(value, field) {
+    if (value === null || value === undefined || value === "") {
+        return null;
+    }
+    const number = Math.trunc(normalizeFiniteNumber(value, field));
+    if (number < 0) {
+        fail(400, `${field} must be zero or greater`);
+    }
+    return number;
+}
+export function normalizeOptionalFiniteNumber(value, field) {
+    if (value === null || value === undefined || value === "") {
+        return null;
+    }
+    return normalizeFiniteNumber(value, field);
+}
+export function normalizeEnumValue(value, field, allowed, fallback) {
+    if (fallback !== undefined &&
+        (value === undefined || value === null || value === "")) {
+        return fallback;
+    }
+    const text = requireNonEmptyString(value, field);
+    if (!allowed.includes(text)) {
+        fail(400, `${field} must be one of: ${allowed.join(", ")}`);
+    }
+    return text;
+}
+export function normalizeValidTimeZone(value, field, fallback = resolveDefaultTimeZone()) {
+    if (value === undefined || value === null) {
+        return fallback;
+    }
+    if (typeof value !== "string") {
+        fail(400, `${field} must be a valid IANA time zone`);
+    }
+    const candidate = value.trim();
+    if (candidate.length === 0) {
+        return fallback;
+    }
+    const normalized = LIFEOPS_TIME_ZONE_ALIASES[candidate.toLowerCase()] ?? candidate;
+    if (!isValidTimeZone(normalized)) {
+        fail(400, `${field} must be a valid IANA time zone`);
+    }
+    return normalized;
+}
+export function normalizePriority(value, current = 3) {
+    if (value === undefined)
+        return current;
+    const priority = Math.trunc(normalizeFiniteNumber(value, "priority"));
+    if (priority < 1 || priority > 5) {
+        fail(400, "priority must be between 1 and 5");
+    }
+    return priority;
+}
+export function normalizePrivacyClass(value, field = "privacyClass", current = "private") {
+    if (value === undefined) {
+        return current;
+    }
+    return normalizeEnumValue(value, field, LIFEOPS_PRIVACY_CLASSES);
+}
+export function normalizePhoneNumber(value, field) {
+    const raw = requireNonEmptyString(value, field);
+    const digits = raw.replace(/[^\d+]/g, "");
+    if (digits.startsWith("+")) {
+        const normalized = `+${digits.slice(1).replace(/\D/g, "")}`;
+        if (!/^\+\d{10,15}$/.test(normalized)) {
+            fail(400, `${field} must be a valid E.164 phone number`);
+        }
+        return normalized;
+    }
+    const plainDigits = digits.replace(/\D/g, "");
+    if (/^\d{10}$/.test(plainDigits)) {
+        return `+1${plainDigits}`;
+    }
+    if (/^1\d{10}$/.test(plainDigits)) {
+        return `+${plainDigits}`;
+    }
+    fail(400, `${field} must be a valid phone number`);
+}
+export function normalizeReminderUrgency(value) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        return "medium";
+    }
+    return normalizeEnumValue(value, "urgency", LIFEOPS_REMINDER_URGENCY_LEVELS);
+}
+//# sourceMappingURL=service-normalize.js.map

package/lifeops-normalize/service-normalize.js.map

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

package/lifeops-normalize/time-zone.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Time-zone normalization helpers (runtime-level primitives).
+ *
+ * Pure `Intl`-backed helpers for resolving and validating IANA time zones.
+ * No DB, no plugin imports. Consumed by the LifeOps normalize primitives and by
+ * `@elizaos/plugin-personal-assistant` (which re-exports them from
+ * `lifeops/defaults.ts` for historical import paths).
+ */
+export declare function resolveDefaultTimeZone(): string;
+export declare function isValidTimeZone(timeZone: string): boolean;
+export declare function normalizeTimeZone(timeZone?: string | null): string;
+//# sourceMappingURL=time-zone.d.ts.map

package/lifeops-normalize/time-zone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-zone.d.ts","sourceRoot":"","sources":["../../src/lifeops-normalize/time-zone.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,wBAAgB,sBAAsB,IAAI,MAAM,CAG/C;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOzD;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAMlE"}

package/lifeops-normalize/time-zone.js

@@ -0,0 +1,29 @@
+/**
+ * Time-zone normalization helpers (runtime-level primitives).
+ *
+ * Pure `Intl`-backed helpers for resolving and validating IANA time zones.
+ * No DB, no plugin imports. Consumed by the LifeOps normalize primitives and by
+ * `@elizaos/plugin-personal-assistant` (which re-exports them from
+ * `lifeops/defaults.ts` for historical import paths).
+ */
+export function resolveDefaultTimeZone() {
+    const resolved = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    return resolved && resolved.trim().length > 0 ? resolved : "UTC";
+}
+export function isValidTimeZone(timeZone) {
+    try {
+        new Intl.DateTimeFormat("en-US", { timeZone }).format(new Date());
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function normalizeTimeZone(timeZone) {
+    const candidate = typeof timeZone === "string" ? timeZone.trim() : "";
+    if (candidate && isValidTimeZone(candidate)) {
+        return candidate;
+    }
+    return resolveDefaultTimeZone();
+}
+//# sourceMappingURL=time-zone.js.map

package/lifeops-normalize/time-zone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-zone.js","sourceRoot":"","sources":["../../src/lifeops-normalize/time-zone.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,UAAU,sBAAsB;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAC;IAClE,OAAO,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAwB;IACxD,MAAM,SAAS,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,IAAI,SAAS,IAAI,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,sBAAsB,EAAE,CAAC;AAClC,CAAC"}

package/local-inference/catalog.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Eliza-curated local model catalog.
+ *
+ * Default local inference is restricted to the active Eliza-1 line:
+ * eliza-1-0_8b, eliza-1-2b, eliza-1-4b, eliza-1-9b, eliza-1-27b,
+ * and eliza-1-27b-256k.
+ * These ship Qwen3.5 bases for 0.8B/2B/4B/9B and Qwen3.6 for 27B. The
+ * 2026-05-12 mandate retired the legacy Qwen3 bases; see
+ * packages/training/scripts/training/model_registry.py for the active
+ * registry. External Hub search remains custom/opt-in and never enters
+ * first-run or default eligibility.
+ */
+import type { CatalogModel } from "./types.js";
+export declare const ELIZA_1_HF_REPO: "elizaos/eliza-1";
+export declare const ELIZA_1_TIER_IDS: readonly ["eliza-1-0_8b", "eliza-1-2b", "eliza-1-4b", "eliza-1-9b", "eliza-1-27b", "eliza-1-27b-256k"];
+export type Eliza1TierId = (typeof ELIZA_1_TIER_IDS)[number];
+export declare const ELIZA_1_RELEASE_TIER_IDS: readonly ["eliza-1-0_8b", "eliza-1-2b", "eliza-1-4b", "eliza-1-9b", "eliza-1-27b", "eliza-1-27b-256k"];
+export declare const ELIZA_1_VISION_TIER_IDS: readonly ["eliza-1-0_8b", "eliza-1-2b", "eliza-1-4b", "eliza-1-9b", "eliza-1-27b", "eliza-1-27b-256k"];
+export declare const ELIZA_1_MTP_TIER_IDS: readonly ["eliza-1-0_8b", "eliza-1-2b", "eliza-1-4b", "eliza-1-9b", "eliza-1-27b", "eliza-1-27b-256k"];
+export declare const FIRST_RUN_DEFAULT_MODEL_ID: Eliza1TierId;
+export declare const DEFAULT_ELIGIBLE_MODEL_IDS: ReadonlySet<string>;
+export declare function isDefaultEligibleId(id: string): boolean;
+/**
+ * Per-tier publish-state hint. Keys are tier ids that are known to have
+ * a pending Hugging Face bundle at the time the catalog snapshot was
+ * cut. Tiers not listed here default to `"published"`. The recommender
+ * consults this map (or a `publishStatus` field on a synthetic
+ * `CatalogModel`) before recommending a first-run default — see
+ * `recommendForFirstRun` and elizaOS/eliza#7629.
+ *
+ * Set the override env var `ELIZA_PUBLISH_STATUS_OVERRIDES` to a JSON
+ * object like `{"eliza-1-2b":"published","eliza-1-9b":"pending"}` to
+ * override at runtime without changing the static map (useful for QA
+ * and for installs that depend on a private HF mirror).
+ *
+ * W3-12 audit (2026-05-14): the following areas require publish attention:
+ *   - 0.8B/2B vision: enabled in the catalog and canonical vision tier set;
+ *     publish staging must include `vision/mmproj-0_8b.gguf` and
+ *     `vision/mmproj-2b.gguf` or manifest validation fails loudly.
+ *   - Voice sub-models (wakeword, turn-detector, speaker-encoder, emotion):
+ *     published under the unified elizaos/eliza-1 `voice/<model-id>/...`
+ *     layout. Per-tier manifests still need to consume these paths directly
+ *     where a bundle wants eager voice downloads.
+ *   - Kokoro same voice preset: `af_same.bin` absent from all
+ *     bundles; I7 eval showed regression. Current bundles ship af_bella
+ *     and standard voices only.
+ */
+export declare const ELIZA_1_TIER_PUBLISH_STATUS: Readonly<Partial<Record<Eliza1TierId, "published" | "pending">>>;
+export declare function eliza1TierPublishStatus(id: Eliza1TierId | string): "published" | "pending";
+export declare const ELIZA_1_PLACEHOLDER_IDS: ReadonlySet<string>;
+export type VoiceBackendId = "kokoro" | "omnivoice";
+/**
+ * Per-tier voice backend policy. The FIRST entry is the default backend
+ * for that tier — `runtime-selection.ts` picks it when both backends are
+ * available and no override applies (voice cloning, TTFA target, RTF).
+ * Entries beyond the first are also bundled; tiers that ship only one
+ * backend have a single-element array.
+ *
+ * Policy:
+ *   - Mobile-class tiers (0_8b / 2b / 4b) → Kokoro only. Kokoro is ~82M
+ *     params (a single ~60-80 MB GGUF) and hits ~97ms CPU TTFB, so it is
+ *     both smaller and faster than OmniVoice (~400-625 MB) — the right
+ *     trade for phones. OmniVoice is not shipped in these bundles. On
+ *     mobile, `selectVoiceBackend({ mobile: true })` also forces Kokoro
+ *     regardless of any env override, so the path is Kokoro-exclusive.
+ *   - 9B → OmniVoice first with Kokoro bundled for hosts with enough memory.
+ *   - Large tiers (27b / 27b-256k) → OmniVoice only. The RAM
+ *     and compute budget is large enough that the OmniVoice quality win
+ *     dominates; Kokoro is not shipped in these bundles.
+ */
+export declare const ELIZA_1_VOICE_BACKENDS: Record<Eliza1TierId, ReadonlyArray<VoiceBackendId>>;
+/**
+ * K-quant ladder for the OmniVoice TTS GGUFs. The omnivoice.cpp
+ * `tools/quantize.cpp` binary already supports the full set Q2_K..Q8_0;
+ * we publish a curated subset that matches the device-class memory budgets
+ * the downloader is expected to choose from. The runtime selects ONE level
+ * via {@link voiceQuantForTier}; the publish path emits ALL levels from
+ * {@link voiceQuantLadderForTier} so the bundle can support a downloader
+ * that picks the level matching the host's RAM/SOC class at install time
+ * (R8 §3 / §7.2). No silent fallback — AGENTS.md §3 forbids "try the
+ * next smaller one" at runtime.
+ *
+ * R8 §2 + omnivoice.cpp/AGENTS.md PolarQuant note: the K-quant family
+ * (Q3..Q6) is the only weight-quant currently wired for OmniVoice's
+ * Qwen3-shaped LM head — PolarQuant / TurboQuant for the LM weight bank
+ * is *plausible* (same arch) but no recipe wires it yet; QJL is N/A
+ * (OmniVoice has no KV cache between MaskGIT steps); V-cache PolarQuant
+ * is N/A for the same reason. See `docs/inference/voice-quant-matrix.md`.
+ */
+export type OmniVoiceQuantLevel = "Q3_K_M" | "Q4_K_M" | "Q5_K_M" | "Q6_K" | "Q8_0";
+export declare function voiceQuantLadderForTier(id: Eliza1TierId): ReadonlyArray<OmniVoiceQuantLevel>;
+export declare function defaultVoiceQuantForTier(id: Eliza1TierId): OmniVoiceQuantLevel;
+export declare const MODEL_CATALOG: CatalogModel[];
+export declare function findCatalogModel(id: string): CatalogModel | undefined;
+export declare function buildHuggingFaceResolveUrlForPath(model: CatalogModel, filePath: string): string;
+export declare function buildHuggingFaceResolveUrl(model: CatalogModel): string;
+//# sourceMappingURL=catalog.d.ts.map

package/local-inference/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/local-inference/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,eAAe,EAAG,iBAA0B,CAAC;AAE1D,eAAO,MAAM,gBAAgB,wGAOnB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,eAAO,MAAM,wBAAwB,wGACmB,CAAC;AAEzD,eAAO,MAAM,uBAAuB,wGAOY,CAAC;AAMjD,eAAO,MAAM,oBAAoB,wGAOe,CAAC;AAcjD,eAAO,MAAM,0BAA0B,EAAE,YAA2B,CAAC;AAErE,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,MAAM,CAE1D,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAChD,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC,CAAC,CAClD,CAAC;AAEP,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,YAAY,GAAG,MAAM,GACxB,WAAW,GAAG,SAAS,CAUzB;AAqBD,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAEvD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEpD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CACzC,YAAY,EACZ,aAAa,CAAC,cAAc,CAAC,CAQ9B,CAAC;AA8LF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,mBAAmB,GAC3B,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,MAAM,CAAC;AAsCX,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,YAAY,GACf,aAAa,CAAC,mBAAmB,CAAC,CAEpC;AAED,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,YAAY,GACf,mBAAmB,CAErB;AAiPD,eAAO,MAAM,aAAa,EAAE,YAAY,EAEvC,CAAC;AAUF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAKrE;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,GACf,MAAM,CA2BR;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAEtE"}