@fallen-8/studio 0.0.37 → 0.0.38

package/dist-lib/types/lib/vectorIndexCreate.d.ts

@@ -0,0 +1,49 @@
+import type { EmbeddingProviderStatsREST, PropertySpecification } from "../api/types";
+/**
+ * What a NEW vector index is created with, in one place: two screens create one (the Indexes
+ * screen's create panel and the Query screen's semantic on-ramp, feature
+ * semantic-search-onramp) and the numbers are not a preference. A bound index whose dimension
+ * or metric disagrees with the model writing into it is refused on every later embed and every
+ * later search, so the provider is the authority and guessing it twice is how the two copies
+ * would drift.
+ */
+/**
+ * Fallbacks for a server that reports no usable provider. Not a recommendation: a shape the
+ * engine accepts, so the form has something to submit while saying (at the call site) that
+ * these are defaults rather than the instance's own numbers.
+ */
+export declare const VECTOR_INDEX_FALLBACK: {
+    readonly dimension: "384";
+    readonly metric: "Cosine";
+};
+export interface VectorIndexDefaults {
+    /** The provider is on AND names a dimension, so its numbers are the authoritative ones. */
+    providerReady: boolean;
+    dimension: string;
+    metric: string;
+}
+/** The dimension + metric a new vector index should default to on this instance. */
+export declare function vectorIndexDefaults(provider: EmbeddingProviderStatsREST | null | undefined): VectorIndexDefaults;
+/** The engine's own bounds on a vector index's dimension (VectorIndex.Initialize). */
+export declare const VECTOR_DIMENSION_RANGE: {
+    readonly min: 1;
+    readonly max: 4096;
+};
+/**
+ * Whether this dimension is one the engine will take. The number input's `min`/`max` are not
+ * enough on their own: neither attribute blocks an EMPTY field, and neither is consulted at all
+ * unless the button is a submit. An empty value travels as `propertyValue: ""` against
+ * `System.Int32`, which the server cannot convert, so the round trip is spent to be told so.
+ */
+export declare function isValidVectorDimension(dimension: string): boolean;
+/**
+ * The `pluginOptions` of POST /index for a vector index. Options travel as typed literals
+ * (vector-index README §creation), and embeddingName/model are emitted only when set, so a raw
+ * index keeps exactly the two-option shape (pinned by index-management.test.tsx).
+ */
+export declare function vectorIndexPluginOptions(options: {
+    dimension: string;
+    metric: string;
+    embeddingName?: string;
+    model?: string;
+}): Record<string, PropertySpecification>;

package/dist-lib/types/state/instanceStore.d.ts

@@ -98,13 +98,23 @@ export interface PathDraft {
     semantic: SemanticDraft;
 }
 export declare const DEFAULT_PATH_DRAFT: PathDraft;
+/** The Query screen's three ways of asking (feature index-workspace / semantic-search-onramp). */
+export declare const QUERY_MODES: readonly ["property", "index", "semantic"];
+export type QueryMode = (typeof QUERY_MODES)[number];
 /**
  * The Query screen's whole input form (feature index-workspace). Persisted per instance
  * so leaving for the Canvas and coming back restores it exactly — results are re-run on
  * demand (kept out of the lean persisted store). Reset via the screen's Clear button.
  */
 export interface QueryDraft {
-    mode: "property" | "index";
+    /**
+     * "semantic" is text-in kNN (feature semantic-search-onramp): its own mode rather than a
+     * source toggle inside the index mode's vector form, because a capability reachable only
+     * after picking the right index is one nobody finds. It shares the kNN parameters below
+     * with that form - same question, different query source - but NOT the index, which is
+     * drawn from a different set (see semanticIndexId).
+     */
+    mode: QueryMode;
     /** Property-scan scope: one named "key" (typed operator) or "any" property (contains search). */
     propertyScope: "key" | "any";
     propertyId: string;
@@ -113,6 +123,13 @@ export interface QueryDraft {
     /** All-property search label restrictor (propertyScope === "any"); empty scans every label. */
     searchLabel: string;
     indexId: string;
+    /**
+     * The semantic mode's index, kept apart from `indexId` because the two modes choose from
+     * different sets: every registered index there, only the ones that can rank a vector here.
+     * Sharing one field meant picking a vector index for a semantic search silently replaced the
+     * operator's index-mode selection AND the query form that went with it.
+     */
+    semanticIndexId: string;
     form: IndexCapability;
     operator: BinaryOperatorName;
     resultType: "Vertices" | "Edges" | "Both";
@@ -124,14 +141,23 @@ export interface QueryDraft {
     fulltextQuery: string;
     spatialElementId: string;
     spatialDistance: string;
+    /** The pasted query vector (index mode, vector form); the semantic mode never uses it. */
     vectorText: string;
     vectorK: string;
     vectorKind: "any" | "vertex" | "edge";
     vectorLabel: string;
-    vectorSource: "vector" | "text";
+    /** The query text of the semantic mode, embedded once server-side. */
     vectorSearchText: string;
 }
 export declare const DEFAULT_QUERY_DRAFT: QueryDraft;
+/**
+ * Rehydrates a persisted Query draft. Text-in kNN used to be a `vectorSource` toggle INSIDE the
+ * index mode's vector form; feature semantic-search-onramp made it its own mode, so a draft
+ * written by an older build is LIFTED rather than dropped: the text, k, kind and label are the
+ * same question asked the same way, and only the route to the form changed. The stale key is
+ * stripped instead of spread through, so nothing carries a field this build has no meaning for.
+ */
+export declare function migrateQueryDraft(persisted: Partial<QueryDraft> | undefined): QueryDraft;
 /**
  * One pattern row of the subgraph builder: a pattern spec plus a stable list key and the
  * step's vertex-slot state (feature subgraph-semantic-thresholds) — the slot MODE and the

package/dist-lib/types/state/integrations.d.ts

@@ -1,5 +1,5 @@
 import type { InstanceConfig } from "../instances/types";
-import type { IntegrationProvider } from "../api/types";
+import type { FileLimits, IntegrationProvider } from "../api/types";
 /**
  * The integrations capability of one instance (feature integrations), read from the one route that
  * answers it: the provider catalog.
@@ -15,6 +15,16 @@ import type { IntegrationProvider } from "../api/types";
  */
 export type IntegrationsCapability = "checking" | "available" | "absent" | "unreachable";
 export declare function useIntegrationProviders(instance: InstanceConfig | null): import("@tanstack/react-query").UseQueryResult<NoInfer<IntegrationProvider[] | null>, unknown>;
+/**
+ * What a job may carry on this instance (feature integration-file-transport). Read once per
+ * instance and held for the session: the ceilings come from configuration, so they change when the
+ * instance is redeployed and never while a screen is open.
+ *
+ * It fails softly on purpose. An instance too old to serve the route answers 404, and a form that
+ * cannot read the ceilings must check NOTHING rather than fall back to a number of its own - see
+ * `lib/fileLimits.ts`, which is the only place allowed to interpret the absence.
+ */
+export declare function useIntegrationLimits(instance: InstanceConfig | null): import("@tanstack/react-query").UseQueryResult<NoInfer<FileLimits | null>, unknown>;
 /** Whether a failure is the capability being off rather than the instance being unwell. */
 export declare function isCapabilityRefusal(error: unknown): boolean;
 /** The capability verdict of a providers query, for the rail and for a deep link. */

package/dist-lib/{typescript-LNGesWYR.js → typescript-BIjKKvsW.js}

@@ -1,4 +1,4 @@
-import { m as s } from "./index-BQbFjItv.js";
+import { m as s } from "./index-0ioFtrZM.js";
 var c = Object.defineProperty, a = Object.getOwnPropertyDescriptor, p = Object.getOwnPropertyNames, g = Object.prototype.hasOwnProperty, l = (t, e, o, i) => {
   if (e && typeof e == "object" || typeof e == "function")
     for (let n of p(e))

package/dist-lib/{xml-BuD_-6ib.js → xml-CT-uMOiT.js}

@@ -1,4 +1,4 @@
-import { m as r } from "./index-BQbFjItv.js";
+import { m as r } from "./index-0ioFtrZM.js";
 var m = Object.defineProperty, c = Object.getOwnPropertyDescriptor, l = Object.getOwnPropertyNames, d = Object.prototype.hasOwnProperty, p = (t, e, o, i) => {
   if (e && typeof e == "object" || typeof e == "function")
     for (let n of l(e))

package/dist-lib/{yaml-DCzPbyTS.js → yaml-Dezcc_VH.js}

@@ -1,4 +1,4 @@
-import { m as l } from "./index-BQbFjItv.js";
+import { m as l } from "./index-0ioFtrZM.js";
 var i = Object.defineProperty, c = Object.getOwnPropertyDescriptor, u = Object.getOwnPropertyNames, s = Object.prototype.hasOwnProperty, d = (n, e, r, o) => {
   if (e && typeof e == "object" || typeof e == "function")
     for (let t of u(e))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fallen-8/studio",
-  "version": "0.0.37",
+  "version": "0.0.38",
   "description": "F8 Studio - browser frontend for Fallen-8 instances, and its graph canvas as a standalone component",
   "license": "MIT",
   "author": "Henning Rauch",