@trustgraph/react-state 1.2.2 → 1.3.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { SocketProvider, SocketContext, ConnectionStateContext, } from "@trustgraph/react-provider";
 export type { SocketProviderProps } from "@trustgraph/react-provider";
-export type { BaseApi, Triple, Value, ConnectionState, StreamingMetadata, } from "@trustgraph/client";
+export type { BaseApi, Triple, Term, IriTerm, BlankTerm, LiteralTerm, TripleTerm, ConnectionState, StreamingMetadata, } from "@trustgraph/client";
 export { NotificationProvider } from "./NotificationProvider";
 export type { NotificationProviderProps } from "./NotificationProvider";
 export type { NotificationHandler } from "./types";
@@ -54,7 +54,8 @@ export { DEFAULT_SETTINGS, SETTINGS_STORAGE_KEY, } from "./model/settings-types"
 export type { LLMModelParameter, EnumOption } from "./model/llm-models";
 export { fileToBase64, textToBase64 } from "./utils/document-encoding";
 export { vectorSearch } from "./utils/vector-search";
-export { getTriples, RDFS_LABEL } from "./utils/knowledge-graph";
+export { getTriples, getTermValue, RDFS_LABEL } from "./utils/knowledge-graph";
+export type { LabeledTerm, LabeledTriple } from "./utils/knowledge-graph";
 export { prepareMetadata, createDocId } from "./model/document-metadata";
 export type { DocumentParameters } from "./model/document-metadata";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.esm.js

@@ -696,36 +696,36 @@ const createDocId = () => {
 const prepareMetadata = (doc_id, params) => {
     let doc_meta = [
         {
-            s: { v: doc_id, e: true },
-            p: { v: RDF_TYPE, e: true },
-            o: { v: DIGITAL_DOCUMENT, e: true },
+            s: { t: "i", i: doc_id },
+            p: { t: "i", i: RDF_TYPE },
+            o: { t: "i", i: DIGITAL_DOCUMENT },
         },
     ];
     if (params.title != "")
         doc_meta = [
             ...doc_meta,
             {
-                s: { v: doc_id, e: true },
-                p: { v: RDFS_LABEL$1, e: true },
-                o: { v: params.title, e: false },
+                s: { t: "i", i: doc_id },
+                p: { t: "i", i: RDFS_LABEL$1 },
+                o: { t: "l", v: params.title ?? "" },
             },
         ];
     if (params.url != "")
         doc_meta = [
             ...doc_meta,
             {
-                s: { v: doc_id, e: true },
-                p: { v: SCHEMA_URL, e: true },
-                o: { v: params.url, e: true },
+                s: { t: "i", i: doc_id },
+                p: { t: "i", i: SCHEMA_URL },
+                o: { t: "i", i: params.url ?? "" },
             },
         ];
-    for (const keyword of params.keywords)
+    for (const keyword of params.keywords ?? [])
         doc_meta = [
             ...doc_meta,
             {
-                s: { v: doc_id, e: true },
-                p: { v: SCHEMA_KEYWORDS, e: true },
-                o: { v: keyword, e: false },
+                s: { t: "i", i: doc_id },
+                p: { t: "i", i: SCHEMA_KEYWORDS },
+                o: { t: "l", v: keyword },
             },
         ];
     return doc_meta;
@@ -969,6 +969,18 @@ const useTriples = ({ flow, s, p, o, limit, collection }) => {
     };
 };
 
+// Helper to get the string value from a Term (IRI or Literal)
+const getTermValue$2 = (term) => {
+    if (term.t === "i")
+        return term.i;
+    if (term.t === "l")
+        return term.v;
+    if (term.t === "b")
+        return term.d;
+    return "";
+};
+// Helper to check if a Term is an IRI
+const isIri$2 = (term) => term.t === "i";
 const RDFS_LABEL = "http://www.w3.org/2000/01/rdf-schema#label";
 const SKOS_DEFINITION = "http://www.w3.org/2004/02/skos/core#definition";
 const SCHEMAORG_SUBJECT_OF = "https://schema.org/subjectOf";
@@ -1000,7 +1012,7 @@ const queryS = (socket, uri, add, remove, limit, collection) => {
     const act = "Query S: " + uri;
     add(act);
     return socket
-        .triplesQuery({ v: uri, e: true }, undefined, undefined, limit ? limit : LIMIT, collection)
+        .triplesQuery({ t: "i", i: uri }, undefined, undefined, limit ? limit : LIMIT, collection)
         .then((x) => {
         remove(act);
         return x;
@@ -1015,7 +1027,7 @@ const queryP = (socket, uri, add, remove, limit, collection) => {
     const act = "Query P: " + uri;
     add(act);
     return socket
-        .triplesQuery(undefined, { v: uri, e: true }, undefined, limit ? limit : LIMIT, collection)
+        .triplesQuery(undefined, { t: "i", i: uri }, undefined, limit ? limit : LIMIT, collection)
         .then((x) => {
         remove(act);
         return x;
@@ -1030,7 +1042,7 @@ const queryO = (socket, uri, add, remove, limit, collection) => {
     const act = "Query O: " + uri;
     add(act);
     return socket
-        .triplesQuery(undefined, undefined, { v: uri, e: true }, limit ? limit : LIMIT, collection)
+        .triplesQuery(undefined, undefined, { t: "i", i: uri }, limit ? limit : LIMIT, collection)
         .then((x) => {
         remove(act);
         return x;
@@ -1072,12 +1084,12 @@ const queryLabel = (socket, uri, add, remove, collection) => {
     add(act);
     // Search tthe graph for the URI->label relationship
     return socket
-        .triplesQuery({ v: uri, e: true }, { v: RDFS_LABEL, e: true }, undefined, 1, collection)
+        .triplesQuery({ t: "i", i: uri }, { t: "i", i: RDFS_LABEL }, undefined, 1, collection)
         .then((triples) => {
         // If got a result, return the label, otherwise the URI
         // can be its own label
         if (triples.length > 0)
-            return triples[0].o.v;
+            return getTermValue$2(triples[0].o);
         else
             return uri;
     })
@@ -1094,7 +1106,7 @@ const queryLabel = (socket, uri, add, remove, collection) => {
 // Returns a promise
 const labelS = (socket, triples, add, remove, collection) => {
     return Promise.all(triples.map((t) => {
-        return queryLabel(socket, t.s.v, add, remove, collection).then((label) => {
+        return queryLabel(socket, getTermValue$2(t.s), add, remove, collection).then((label) => {
             return {
                 ...t,
                 s: {
@@ -1109,7 +1121,7 @@ const labelS = (socket, triples, add, remove, collection) => {
 // Returns a promise
 const labelP = (socket, triples, add, remove, collection) => {
     return Promise.all(triples.map((t) => {
-        return queryLabel(socket, t.p.v, add, remove, collection).then((label) => {
+        return queryLabel(socket, getTermValue$2(t.p), add, remove, collection).then((label) => {
             return {
                 ...t,
                 p: {
@@ -1124,10 +1136,10 @@ const labelP = (socket, triples, add, remove, collection) => {
 // Returns a promise
 const labelO = (socket, triples, add, remove, collection) => {
     return Promise.all(triples.map((t) => {
-        // If the 'o' element is a entity, do a label lookup, else
+        // If the 'o' element is an IRI, do a label lookup, else
         // just use the literal value for its label
-        if (t.o.e)
-            return queryLabel(socket, t.o.v, add, remove, collection).then((label) => {
+        if (isIri$2(t.o))
+            return queryLabel(socket, t.o.i, add, remove, collection).then((label) => {
                 return {
                     ...t,
                     o: {
@@ -1142,7 +1154,7 @@ const labelO = (socket, triples, add, remove, collection) => {
                     ...t,
                     o: {
                         ...t.o,
-                        label: t.o.v,
+                        label: getTermValue$2(t.o),
                     },
                 });
             });
@@ -1150,7 +1162,7 @@ const labelO = (socket, triples, add, remove, collection) => {
 };
 // Filter out 'structural' edges nobody needs to see
 const filterInternals = (triples) => triples.filter((t) => {
-    if (t.p.e && t.p.v == RDFS_LABEL)
+    if (isIri$2(t.p) && t.p.i == RDFS_LABEL)
         return false;
     return true;
 });
@@ -1177,6 +1189,18 @@ const getTriples = (socket, uri, add, remove, limit, collection) => {
 
 // Functionality here helps construct subgraphs for react-force-graph
 // visualisation
+// Helper to get the string value from a Term (IRI or Literal)
+const getTermValue$1 = (term) => {
+    if (term.t === "i")
+        return term.i;
+    if (term.t === "l")
+        return term.v;
+    if (term.t === "b")
+        return term.d;
+    return "";
+};
+// Helper to check if a Term is an IRI
+const isIri$1 = (term) => term.t === "i";
 const createSubgraph = () => {
     return {
         nodes: [],
@@ -1190,19 +1214,20 @@ const updateSubgraphTriples = (sg, triples) => {
     for (const t of triples) {
         // Skip triples where the object is a literal (property edges)
         // These are now shown in the node details drawer instead
-        if (!t.o.e) {
+        if (!isIri$1(t.o)) {
             continue;
         }
         // Source has a URI, that can be its unique ID
-        const sourceId = t.s.v;
+        const sourceId = getTermValue$1(t.s);
         // Target is always an entity now (we filtered out literals above)
-        const targetId = t.o.v;
+        const targetId = getTermValue$1(t.o);
         // Links have an ID so that this edge is unique
-        const linkId = t.s.v + "@@" + t.p.v + "@@" + t.o.v;
+        const linkId = getTermValue$1(t.s) + "@@" + getTermValue$1(t.p) + "@@" + getTermValue$1(t.o);
         if (!nodeIds.has(sourceId)) {
+            const sLabeled = t.s;
             const n = {
                 id: sourceId,
-                label: t.s.label ? t.s.label : "unknown",
+                label: sLabeled.label ? sLabeled.label : "unknown",
                 group: groupId,
             };
             nodeIds.add(sourceId);
@@ -1212,9 +1237,10 @@ const updateSubgraphTriples = (sg, triples) => {
             };
         }
         if (!nodeIds.has(targetId)) {
+            const oLabeled = t.o;
             const n = {
                 id: targetId,
-                label: t.o.label ? t.o.label : "unknown",
+                label: oLabeled.label ? oLabeled.label : "unknown",
                 group: groupId,
             };
             nodeIds.add(targetId);
@@ -1224,11 +1250,12 @@ const updateSubgraphTriples = (sg, triples) => {
             };
         }
         if (!linkIds.has(linkId)) {
+            const pLabeled = t.p;
             const l = {
                 source: sourceId,
                 target: targetId,
                 id: linkId,
-                label: t.p.label ? t.p.label : "unknown",
+                label: pLabeled.label ? pLabeled.label : "unknown",
                 value: 1,
             };
             linkIds.add(linkId);
@@ -1253,14 +1280,14 @@ const updateSubgraphByRelationship = (socket, selectedNodeId, relationshipUri, d
     add(activityName);
     // Build the query based on direction
     const queryPromise = direction === "outgoing"
-        ? socket.triplesQuery({ v: selectedNodeId, e: true }, // s = selectedNode
-        { v: relationshipUri, e: true }, // p = relationship
+        ? socket.triplesQuery({ t: "i", i: selectedNodeId }, // s = selectedNode
+        { t: "i", i: relationshipUri }, // p = relationship
         undefined, // o = ??? (what we want to find)
         20, // Limit results
         collection)
         : socket.triplesQuery(undefined, // s = ??? (what we want to find)
-        { v: relationshipUri, e: true }, // p = relationship
-        { v: selectedNodeId, e: true }, // o = selectedNode
+        { t: "i", i: relationshipUri }, // p = relationship
+        { t: "i", i: selectedNodeId }, // o = selectedNode
         20, // Limit results
         collection);
     return queryPromise
@@ -1433,8 +1460,10 @@ const getGraphEmbeddings = (socket, add, remove, limit, collection) => {
             .graphEmbeddingsQuery(vecs, limit , collection)
             .then((ents) => {
             remove(act);
-            return ents.map((ent) => {
-                return { uri: ent.v, target: vecs[0] };
+            return ents
+                .filter((ent) => ent.t === "i")
+                .map((ent) => {
+                return { uri: ent.i, target: vecs[0] };
             });
         })
             .catch((err) => {
@@ -1449,7 +1478,7 @@ const addRowLabels = (socket, add, remove, collection) => (entities) => {
         const act = "Label " + ent.uri;
         add(act);
         return socket
-            .triplesQuery({ v: ent.uri, e: true }, { v: RDFS_LABEL, e: true }, undefined, 1, collection)
+            .triplesQuery({ t: "i", i: ent.uri }, { t: "i", i: RDFS_LABEL }, undefined, 1, collection)
             .then((t) => {
             if (t.length < 1) {
                 remove(act);
@@ -1461,9 +1490,10 @@ const addRowLabels = (socket, add, remove, collection) => (entities) => {
             }
             else {
                 remove(act);
+                const obj = t[0].o;
                 return {
                     uri: ent.uri,
-                    label: t[0].o.v,
+                    label: obj.v,
                     target: ent.target,
                 };
             }
@@ -1482,7 +1512,7 @@ const addRowDefinitions = (socket, add, remove, collection) =>
         const act = "Description " + ent.uri;
         add(act);
         return socket
-            .triplesQuery({ v: ent.uri, e: true }, { v: SKOS_DEFINITION, e: true }, undefined, 1, collection)
+            .triplesQuery({ t: "i", i: ent.uri }, { t: "i", i: SKOS_DEFINITION }, undefined, 1, collection)
             .then((t) => {
             if (t.length < 1) {
                 remove(act);
@@ -1490,9 +1520,10 @@ const addRowDefinitions = (socket, add, remove, collection) =>
             }
             else {
                 remove(act);
+                const obj = t[0].o;
                 return {
                     ...ent,
-                    description: t[0].o.v,
+                    description: obj.v,
                 };
             }
         })
@@ -1868,12 +1899,12 @@ const useChatSession = () => {
             addActivity(embActivity);
             // Get labels for each entity
             const labelPromises = result.entities.map(async (entity) => {
-                const labelActivity = "Label " + entity.v;
+                const labelActivity = "Label " + getTermValue$2(entity);
                 addActivity(labelActivity);
                 try {
                     const triples = await socket
                         .flow(flowId)
-                        .triplesQuery(entity, { v: RDFS_LABEL, e: true }, undefined, 1, settings.collection);
+                        .triplesQuery(entity, { t: "i", i: RDFS_LABEL }, undefined, 1, settings.collection);
                     removeActivity(labelActivity);
                     return triples;
                 }
@@ -1887,8 +1918,8 @@ const useChatSession = () => {
             const entityList = labelResponses
                 .filter((resp) => resp && resp.length > 0)
                 .map((resp) => ({
-                label: resp[0].o.v,
-                uri: resp[0].s.v,
+                label: getTermValue$2(resp[0].o),
+                uri: getTermValue$2(resp[0].s),
             }));
             setEntities(entityList);
             removeActivity(embActivity);
@@ -4079,6 +4110,18 @@ const useParameterValidation = (parameterDefinitions, parameterMapping, paramete
     ]);
 };
 
+// Helper to get the string value from a Term (IRI or Literal)
+const getTermValue = (term) => {
+    if (term.t === "i")
+        return term.i;
+    if (term.t === "l")
+        return term.v;
+    if (term.t === "b")
+        return term.d;
+    return "";
+};
+// Helper to check if a Term is an IRI
+const isIri = (term) => term.t === "i";
 /**
  * Standard URI to label mappings
  * These common URIs are mapped directly without knowledge graph queries
@@ -4129,10 +4172,10 @@ const useNodeDetails = (nodeId, flowId) => {
             if (!nodeId) {
                 throw new Error("Node ID is required");
             }
-            const subjectValue = { v: nodeId, e: true };
+            const subjectTerm = { t: "i", i: nodeId };
             return socket
                 .flow(flowId)
-                .triplesQuery(subjectValue, undefined, undefined, 20, settings.collection)
+                .triplesQuery(subjectTerm, undefined, undefined, 20, settings.collection)
                 .then((triples) => {
                 if (!Array.isArray(triples)) {
                     console.error("Expected triples array, got:", triples);
@@ -4158,10 +4201,10 @@ const useNodeDetails = (nodeId, flowId) => {
             if (!nodeId) {
                 throw new Error("Node ID is required");
             }
-            const objectValue = { v: nodeId, e: true };
+            const objectTerm = { t: "i", i: nodeId };
             return socket
                 .flow(flowId)
-                .triplesQuery(undefined, undefined, objectValue, 20, settings.collection)
+                .triplesQuery(undefined, undefined, objectTerm, 20, settings.collection)
                 .then((triples) => {
                 if (!Array.isArray(triples)) {
                     console.error("Expected triples array, got:", triples);
@@ -4187,17 +4230,17 @@ const useNodeDetails = (nodeId, flowId) => {
             if (!nodeId) {
                 throw new Error("Node ID is required");
             }
-            const subjectValue = { v: nodeId, e: true };
+            const subjectTerm = { t: "i", i: nodeId };
             return socket
                 .flow(flowId)
-                .triplesQuery(subjectValue, undefined, undefined, 50, settings.collection) // More limit for properties
+                .triplesQuery(subjectTerm, undefined, undefined, 50, settings.collection) // More limit for properties
                 .then((triples) => {
                 if (!Array.isArray(triples)) {
                     console.error("Expected triples array, got:", triples);
                     throw new Error("Invalid triples response");
                 }
-                // Filter for properties (where o.e === false)
-                return triples.filter((triple) => triple.o && triple.o.e === false);
+                // Filter for properties (where o is not an IRI, i.e., literals)
+                return triples.filter((triple) => triple.o && !isIri(triple.o));
             })
                 .catch((err) => {
                 console.error("Error fetching properties:", err);
@@ -4217,9 +4260,9 @@ const useNodeDetails = (nodeId, flowId) => {
         // Filter for entity relationships and extract unique predicates
         const uniqueRelationships = new Set();
         outboundTriplesQuery.data.forEach((triple) => {
-            // Check if object is an entity (o.e === true)
-            if (triple.o && triple.o.e === true && triple.p && triple.p.v) {
-                uniqueRelationships.add(triple.p.v);
+            // Check if object is an IRI (entity)
+            if (triple.o && isIri(triple.o) && triple.p && isIri(triple.p)) {
+                uniqueRelationships.add(triple.p.i);
             }
         });
         // Convert Set to array
@@ -4235,9 +4278,9 @@ const useNodeDetails = (nodeId, flowId) => {
         // Filter for entity relationships and extract unique predicates
         const uniqueRelationships = new Set();
         inboundTriplesQuery.data.forEach((triple) => {
-            // Check if subject is an entity (s.e === true)
-            if (triple.s && triple.s.e === true && triple.p && triple.p.v) {
-                uniqueRelationships.add(triple.p.v);
+            // Check if subject is an IRI (entity)
+            if (triple.s && isIri(triple.s) && triple.p && isIri(triple.p)) {
+                uniqueRelationships.add(triple.p.i);
             }
         });
         // Convert Set to array
@@ -4253,8 +4296,8 @@ const useNodeDetails = (nodeId, flowId) => {
         // Extract unique property predicates
         const uniqueProperties = new Set();
         propertiesQuery.data.forEach((triple) => {
-            if (triple.p && triple.p.v) {
-                uniqueProperties.add(triple.p.v);
+            if (triple.p && isIri(triple.p)) {
+                uniqueProperties.add(triple.p.i);
             }
         });
         // Convert Set to array
@@ -4283,14 +4326,14 @@ const useNodeDetails = (nodeId, flowId) => {
                 }
                 // If not in standard mappings, query the knowledge graph
                 try {
-                    const subjectValue = { v: relationshipURI, e: true };
-                    const predicateValue = { v: RDFS_LABEL, e: true };
+                    const subjectTerm = { t: "i", i: relationshipURI };
+                    const predicateTerm = { t: "i", i: RDFS_LABEL };
                     const labelTriples = await socket
                         .flow(flowId)
-                        .triplesQuery(subjectValue, predicateValue, undefined, 1, settings.collection);
+                        .triplesQuery(subjectTerm, predicateTerm, undefined, 1, settings.collection);
                     // Extract label from the first result, or use URI as fallback
                     if (labelTriples && labelTriples.length > 0 && labelTriples[0].o) {
-                        labelMap[relationshipURI] = labelTriples[0].o.v;
+                        labelMap[relationshipURI] = getTermValue(labelTriples[0].o);
                     }
                     else {
                         labelMap[relationshipURI] = relationshipURI;
@@ -4328,14 +4371,14 @@ const useNodeDetails = (nodeId, flowId) => {
                 }
                 // If not in standard mappings, query the knowledge graph
                 try {
-                    const subjectValue = { v: relationshipURI, e: true };
-                    const predicateValue = { v: RDFS_LABEL, e: true };
+                    const subjectTerm = { t: "i", i: relationshipURI };
+                    const predicateTerm = { t: "i", i: RDFS_LABEL };
                     const labelTriples = await socket
                         .flow(flowId)
-                        .triplesQuery(subjectValue, predicateValue, undefined, 1, settings.collection);
+                        .triplesQuery(subjectTerm, predicateTerm, undefined, 1, settings.collection);
                     // Extract label from the first result, or use URI as fallback
                     if (labelTriples && labelTriples.length > 0 && labelTriples[0].o) {
-                        labelMap[relationshipURI] = labelTriples[0].o.v;
+                        labelMap[relationshipURI] = getTermValue(labelTriples[0].o);
                     }
                     else {
                         labelMap[relationshipURI] = relationshipURI;
@@ -4373,14 +4416,14 @@ const useNodeDetails = (nodeId, flowId) => {
                 }
                 // If not in standard mappings, query the knowledge graph
                 try {
-                    const subjectValue = { v: propertyURI, e: true };
-                    const predicateValue = { v: RDFS_LABEL, e: true };
+                    const subjectTerm = { t: "i", i: propertyURI };
+                    const predicateTerm = { t: "i", i: RDFS_LABEL };
                     const labelTriples = await socket
                         .flow(flowId)
-                        .triplesQuery(subjectValue, predicateValue, undefined, 1, settings.collection);
+                        .triplesQuery(subjectTerm, predicateTerm, undefined, 1, settings.collection);
                     // Extract label from the first result, or use URI as fallback
                     if (labelTriples && labelTriples.length > 0 && labelTriples[0].o) {
-                        labelMap[propertyURI] = labelTriples[0].o.v;
+                        labelMap[propertyURI] = getTermValue(labelTriples[0].o);
                     }
                     else {
                         labelMap[propertyURI] = propertyURI;
@@ -4427,15 +4470,20 @@ const useNodeDetails = (nodeId, flowId) => {
         return propertiesQuery.data
             .filter((triple) => {
             // Exclude label properties (RDFS_LABEL) since node label is already shown
-            return triple.p?.v !== RDFS_LABEL;
+            const pUri = triple.p && isIri(triple.p) ? triple.p.i : "";
+            return pUri !== RDFS_LABEL;
         })
-            .map((triple) => ({
-            predicate: {
-                uri: triple.p?.v || "",
-                label: propertyLabelsQuery.data?.[triple.p?.v || ""] || triple.p?.v || "",
-            },
-            value: triple.o?.v || "",
-        }));
+            .map((triple) => {
+            const pUri = triple.p && isIri(triple.p) ? triple.p.i : "";
+            const oValue = triple.o ? getTermValue(triple.o) : "";
+            return {
+                predicate: {
+                    uri: pUri,
+                    label: propertyLabelsQuery.data?.[pUri] || pUri,
+                },
+                value: oValue,
+            };
+        });
     }, [propertiesQuery.data, propertyLabelsQuery.data]);
     // Show loading indicators for long-running operations
     useActivity(outboundTriplesQuery.isLoading ||
@@ -4523,5 +4571,5 @@ const useNodeDetails = (nodeId, flowId) => {
     };
 };
 
-export { DEFAULT_SETTINGS, NotificationProvider, RDFS_LABEL, SETTINGS_STORAGE_KEY, createDocId, fileToBase64, generateFlowBlueprintId, getTriples, prepareMetadata, textToBase64, useActivity, useAgentTools, useChat, useChatSession, useCollections, useConversation, useEmbeddings, useEntityDetail, useFlowBlueprints, useFlowParameters, useFlows, useGraphEmbeddings, useGraphSubgraph, useInference, useKnowledgeCores, useLLMModels, useLibrary, useLoadStateStore, useMcpTools, useNlpQuery, useNodeDetails, useNotification, useObjectsQuery, useOntologies, useParameterValidation, useProcessing, useProgressStateStore, usePrompts, useSchemas, useSearchStateStore, useSessionStore, useSettings, useStructuredQuery, useTokenCosts, useTriples, useVectorSearch, useWorkbenchStateStore, vectorSearch };
+export { DEFAULT_SETTINGS, NotificationProvider, RDFS_LABEL, SETTINGS_STORAGE_KEY, createDocId, fileToBase64, generateFlowBlueprintId, getTermValue$2 as getTermValue, getTriples, prepareMetadata, textToBase64, useActivity, useAgentTools, useChat, useChatSession, useCollections, useConversation, useEmbeddings, useEntityDetail, useFlowBlueprints, useFlowParameters, useFlows, useGraphEmbeddings, useGraphSubgraph, useInference, useKnowledgeCores, useLLMModels, useLibrary, useLoadStateStore, useMcpTools, useNlpQuery, useNodeDetails, useNotification, useObjectsQuery, useOntologies, useParameterValidation, useProcessing, useProgressStateStore, usePrompts, useSchemas, useSearchStateStore, useSessionStore, useSettings, useStructuredQuery, useTokenCosts, useTriples, useVectorSearch, useWorkbenchStateStore, vectorSearch };
 //# sourceMappingURL=index.esm.js.map