@elizaos/plugin-local-inference 2.0.0-beta.1 → 2.0.11-beta.7

package/src/services/manifest/types.d.ts

@@ -0,0 +1,30 @@
+import type { z } from "zod";
+import type { CpuFeatureProbe } from "../types";
+import type { ELIZA_1_PROVENANCE_SLOTS, ELIZA_1_RELEASE_CHANNELS, ELIZA_1_RELEASE_STATES, Eliza1BackendEnumSchema, Eliza1EvalsSchema, Eliza1FileEntrySchema, Eliza1FilesSchema, Eliza1KernelEnumSchema, Eliza1KernelsSchema, Eliza1LineageSchema, Eliza1ManifestSchema, Eliza1ProvenanceSchema, Eliza1RamBudgetSchema, Eliza1TierEnumSchema, Eliza1VerifiedBackendStatusSchema, Eliza1VoiceSchema } from "./schema";
+export type Eliza1Tier = z.infer<typeof Eliza1TierEnumSchema>;
+export type Eliza1Kernel = z.infer<typeof Eliza1KernelEnumSchema>;
+export type Eliza1Backend = z.infer<typeof Eliza1BackendEnumSchema>;
+export type Eliza1FileEntry = z.infer<typeof Eliza1FileEntrySchema>;
+export type Eliza1Files = z.infer<typeof Eliza1FilesSchema>;
+export type Eliza1Lineage = z.infer<typeof Eliza1LineageSchema>;
+export type Eliza1Kernels = z.infer<typeof Eliza1KernelsSchema>;
+export type Eliza1Evals = z.infer<typeof Eliza1EvalsSchema>;
+export type Eliza1RamBudget = z.infer<typeof Eliza1RamBudgetSchema>;
+export type Eliza1Voice = z.infer<typeof Eliza1VoiceSchema>;
+export type Eliza1Provenance = z.infer<typeof Eliza1ProvenanceSchema>;
+export type Eliza1ProvenanceSlot = (typeof ELIZA_1_PROVENANCE_SLOTS)[number];
+export type Eliza1ReleaseState = (typeof ELIZA_1_RELEASE_STATES)[number];
+export type Eliza1ReleaseChannel = (typeof ELIZA_1_RELEASE_CHANNELS)[number];
+export type Eliza1VerifiedBackendStatus = z.infer<typeof Eliza1VerifiedBackendStatusSchema>;
+export type Eliza1Manifest = z.infer<typeof Eliza1ManifestSchema>;
+/**
+ * Capability snapshot of a target device — whatever the runtime detected
+ * (Metal on Mac, Vulkan on Linux/Android, CUDA on NVIDIA, CPU as floor).
+ * `canSetAsDefault()` checks the manifest's verifiedBackends against this.
+ */
+export interface Eliza1DeviceCaps {
+    availableBackends: ReadonlyArray<Eliza1Backend>;
+    ramMb: number;
+    cpuFeatures?: CpuFeatureProbe;
+}
+//# sourceMappingURL=types.d.ts.map

package/src/services/manifest/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EACX,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,iCAAiC,EACjC,iBAAiB,EACjB,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAC9D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACpE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7E,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AACzE,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7E,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,iCAAiC,CACxC,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAChC,iBAAiB,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,eAAe,CAAC;CAC9B"}

package/src/services/manifest/types.ts

@@ -0,0 +1,55 @@
+// TypeScript types derived from the Zod schema in `./schema.ts`.
+// Importing this module gives consumers a strongly-typed view of an Eliza-1
+// manifest without depending on Zod at runtime — useful for catalog code,
+// recommendation, and downloader interfaces that only read manifests.
+
+import type { z } from "zod";
+import type { CpuFeatureProbe } from "../types";
+import type {
+	ELIZA_1_PROVENANCE_SLOTS,
+	ELIZA_1_RELEASE_CHANNELS,
+	ELIZA_1_RELEASE_STATES,
+	Eliza1BackendEnumSchema,
+	Eliza1EvalsSchema,
+	Eliza1FileEntrySchema,
+	Eliza1FilesSchema,
+	Eliza1KernelEnumSchema,
+	Eliza1KernelsSchema,
+	Eliza1LineageSchema,
+	Eliza1ManifestSchema,
+	Eliza1ProvenanceSchema,
+	Eliza1RamBudgetSchema,
+	Eliza1TierEnumSchema,
+	Eliza1VerifiedBackendStatusSchema,
+	Eliza1VoiceSchema,
+} from "./schema";
+
+export type Eliza1Tier = z.infer<typeof Eliza1TierEnumSchema>;
+export type Eliza1Kernel = z.infer<typeof Eliza1KernelEnumSchema>;
+export type Eliza1Backend = z.infer<typeof Eliza1BackendEnumSchema>;
+export type Eliza1FileEntry = z.infer<typeof Eliza1FileEntrySchema>;
+export type Eliza1Files = z.infer<typeof Eliza1FilesSchema>;
+export type Eliza1Lineage = z.infer<typeof Eliza1LineageSchema>;
+export type Eliza1Kernels = z.infer<typeof Eliza1KernelsSchema>;
+export type Eliza1Evals = z.infer<typeof Eliza1EvalsSchema>;
+export type Eliza1RamBudget = z.infer<typeof Eliza1RamBudgetSchema>;
+export type Eliza1Voice = z.infer<typeof Eliza1VoiceSchema>;
+export type Eliza1Provenance = z.infer<typeof Eliza1ProvenanceSchema>;
+export type Eliza1ProvenanceSlot = (typeof ELIZA_1_PROVENANCE_SLOTS)[number];
+export type Eliza1ReleaseState = (typeof ELIZA_1_RELEASE_STATES)[number];
+export type Eliza1ReleaseChannel = (typeof ELIZA_1_RELEASE_CHANNELS)[number];
+export type Eliza1VerifiedBackendStatus = z.infer<
+	typeof Eliza1VerifiedBackendStatusSchema
+>;
+export type Eliza1Manifest = z.infer<typeof Eliza1ManifestSchema>;
+
+/**
+ * Capability snapshot of a target device — whatever the runtime detected
+ * (Metal on Mac, Vulkan on Linux/Android, CUDA on NVIDIA, CPU as floor).
+ * `canSetAsDefault()` checks the manifest's verifiedBackends against this.
+ */
+export interface Eliza1DeviceCaps {
+	availableBackends: ReadonlyArray<Eliza1Backend>;
+	ramMb: number;
+	cpuFeatures?: CpuFeatureProbe;
+}

package/src/services/manifest/validator.d.ts

@@ -0,0 +1,66 @@
+import type { Eliza1DeviceCaps, Eliza1Kernel, Eliza1Manifest, Eliza1Tier } from "./types";
+export interface ValidationOk {
+    ok: true;
+    manifest: Eliza1Manifest;
+}
+export interface ValidationErr {
+    ok: false;
+    errors: ReadonlyArray<string>;
+}
+export type ValidationResult = ValidationOk | ValidationErr;
+/**
+ * Schema + contract validation. Returns a Result-shaped object so callers
+ * can inspect every error rather than catching the first thrown one.
+ *
+ * Throws nothing for invalid input — invalid manifests are reported via
+ * `{ ok: false, errors }`. Truly exceptional cases (non-object input)
+ * surface as Zod issues, not exceptions.
+ */
+export declare function validateManifest(input: unknown): ValidationResult;
+/**
+ * Throws on invalid input. Use this from boot paths where a structured
+ * error is already attached at the boundary. Internal use only — UI
+ * code should prefer `validateManifest`.
+ */
+export declare function parseManifestOrThrow(input: unknown): Eliza1Manifest;
+/**
+ * `canSetAsDefault` is the recommendation-engine gate. A manifest that
+ * passes this is allowed to fill an empty default slot for the device:
+ *
+ *   - the manifest is contract-valid (every required kernel declared, every
+ *     required eval green for a strict release, lineage/files consistent),
+ *   - the device RAM meets the manifest's `ramBudgetMb.min` floor,
+ *   - the device exposes at least one backend the manifest verified `pass`
+ *     on out of the tier's supported set.
+ *
+ * A `defaultEligible: true` manifest is the strict release: every supported
+ * backend kernel-verified `pass`, every required eval green. A
+ * `defaultEligible: false` manifest with an explicit candidate/staging
+ * `releaseState` (`base-v1-candidate`, `local-standin`, `upload-candidate`)
+ * is still permitted to fill an empty default slot **when this device can
+ * run it** — the recommender prefers a strict release over a candidate when
+ * both are installed (see `isStrictReleaseManifest`). Version-only staging
+ * stamps such as `1.0.0-weights-staged.2` are accepted by the install parser
+ * so QA bundles can be materialized, but they do not get this auto-default
+ * relaxation unless the manifest also carries an explicit staging
+ * `releaseState`.
+ *
+ * The device-caps check rejects "this device has Vulkan only but the
+ * manifest only verified Metal/CUDA" — a manifest may be contract-valid
+ * but not runnable on this device.
+ */
+export declare function canSetAsDefault(manifest: Eliza1Manifest, device: Eliza1DeviceCaps): boolean;
+/**
+ * Strict release identifier: a `defaultEligible: true` manifest. The
+ * recommender uses this to prefer a strict release over a candidate
+ * bundle when both are installed and contract-valid. Mirrors the
+ * publish-side `eliza1_gates.yaml` strict bar.
+ */
+export declare function isStrictReleaseManifest(manifest: Eliza1Manifest): boolean;
+/**
+ * Convenience: list missing required kernels for a tier without doing
+ * full validation. Used by the recommendation engine when surfacing
+ * "this bundle is broken" diagnostics.
+ */
+export declare function missingRequiredKernels(tier: Eliza1Tier, declaredRequired: ReadonlyArray<Eliza1Kernel>): ReadonlyArray<Eliza1Kernel>;
+//# sourceMappingURL=validator.d.ts.map

package/src/services/manifest/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["validator.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAEX,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,aAAa,CAAC;AAE5D;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAkBjE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAQnE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,eAAe,CAC9B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,gBAAgB,GACtB,OAAO,CAoBT;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAEzE;AAgZD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,UAAU,EAChB,gBAAgB,EAAE,aAAa,CAAC,YAAY,CAAC,GAC3C,aAAa,CAAC,YAAY,CAAC,CAG7B"}