@adventurelabs/scout-core 1.4.13 → 1.4.15

package/dist/helpers/artifacts.d.ts

@@ -1,4 +1,4 @@
-import { IArtifactWithMediaUrl } from "../types/db";
+import { IArtifact, IArtifactWithMediaUrl, ArtifactInsert, ArtifactUpdate } from "../types/db";
 import { IWebResponseCompatible } from "../types/requests";
 import { SupabaseClient } from "@supabase/supabase-js";
 export declare function server_get_artifacts_by_herd(herd_id: number, limit?: number, offset?: number, client?: SupabaseClient): Promise<IWebResponseCompatible<IArtifactWithMediaUrl[]>>;
@@ -7,3 +7,15 @@ export declare function server_get_total_artifacts_by_herd(herd_id: number): Pro
 export declare function server_get_artifacts_by_device_ids_batch(device_ids: number[], limit_per_device?: number, client?: SupabaseClient): Promise<{
     [device_id: number]: IArtifactWithMediaUrl[];
 }>;
+export declare function server_insert_artifact(artifact: ArtifactInsert | ArtifactInsert[], client?: SupabaseClient): Promise<IWebResponseCompatible<IArtifact[]>>;
+export declare function server_update_artifact(artifact: (ArtifactUpdate & {
+    id: number;
+}) | (ArtifactUpdate & {
+    id: number;
+})[], client?: SupabaseClient): Promise<IWebResponseCompatible<IArtifact[]>>;
+export declare function server_delete_artifact(id: number | number[], client?: SupabaseClient): Promise<IWebResponseCompatible<boolean>>;
+/** Semantic search over artifacts using Vertex multimodal embedding (embedding_vertex_mm_01). */
+export declare function server_match_artifacts_by_vertex_embedding(query_embedding: number[], match_threshold: number, match_count: number, options?: {
+    herd_id?: number | null;
+    client?: SupabaseClient;
+}): Promise<IWebResponseCompatible<IArtifact[]>>;

package/dist/helpers/artifacts.js

@@ -119,3 +119,59 @@ export async function server_get_artifacts_by_device_ids_batch(device_ids, limit
     });
     return artifactsByDevice;
 }
+export async function server_insert_artifact(artifact, client) {
+    const supabase = client || (await newServerClient());
+    const arr = Array.isArray(artifact) ? artifact : [artifact];
+    const { data, error } = await supabase
+        .from("artifacts")
+        .insert(arr)
+        .select("*");
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    return IWebResponse.success(data || []).to_compatible();
+}
+export async function server_update_artifact(artifact, client) {
+    const supabase = client || (await newServerClient());
+    const arr = Array.isArray(artifact) ? artifact : [artifact];
+    const results = [];
+    for (const record of arr) {
+        const { id, ...updateData } = record;
+        delete updateData.created_at;
+        const { data, error } = await supabase
+            .from("artifacts")
+            .update(updateData)
+            .eq("id", id)
+            .select("*")
+            .single();
+        if (error) {
+            return IWebResponse.error(error.message).to_compatible();
+        }
+        if (data)
+            results.push(data);
+    }
+    return IWebResponse.success(results).to_compatible();
+}
+export async function server_delete_artifact(id, client) {
+    const supabase = client || (await newServerClient());
+    const ids = Array.isArray(id) ? id : [id];
+    const { error } = await supabase.from("artifacts").delete().in("id", ids);
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    return IWebResponse.success(true).to_compatible();
+}
+/** Semantic search over artifacts using Vertex multimodal embedding (embedding_vertex_mm_01). */
+export async function server_match_artifacts_by_vertex_embedding(query_embedding, match_threshold, match_count, options) {
+    const supabase = options?.client ?? (await newServerClient());
+    const { data, error } = await supabase.rpc("match_artifacts_by_vertex_embedding", {
+        query_embedding: query_embedding,
+        match_threshold,
+        match_count,
+        herd_id_caller: options?.herd_id ?? null,
+    });
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    return IWebResponse.success((data ?? [])).to_compatible();
+}

package/dist/helpers/events.d.ts

@@ -9,3 +9,8 @@ export declare function server_update_event(events: (EventUpdate & {
 }) | (EventUpdate & {
     id: number;
 })[], client?: SupabaseClient): Promise<IWebResponseCompatible<IEvent[]>>;
+/** Semantic search over events using Vertex multimodal embedding (embedding_vertex_mm_01). */
+export declare function server_match_events_by_vertex_embedding(query_embedding: number[], match_threshold: number, match_count: number, options?: {
+    herd_id?: number | null;
+    client?: SupabaseClient;
+}): Promise<IWebResponseCompatible<IEvent[]>>;

package/dist/helpers/events.js

@@ -70,3 +70,18 @@ export async function server_update_event(events, client) {
     }
     return IWebResponse.success(updatedEvents).to_compatible();
 }
+/** Semantic search over events using Vertex multimodal embedding (embedding_vertex_mm_01). */
+export async function server_match_events_by_vertex_embedding(query_embedding, match_threshold, match_count, options) {
+    const supabase = options?.client ?? (await newServerClient());
+    const rpcName = "match_events_by_vertex_embedding";
+    const { data, error } = await supabase.rpc(rpcName, {
+        query_embedding: JSON.stringify(query_embedding),
+        match_threshold,
+        match_count,
+        herd_id_caller: options?.herd_id ?? undefined,
+    });
+    if (error) {
+        return IWebResponse.error(error.message).to_compatible();
+    }
+    return IWebResponse.success((data ?? [])).to_compatible();
+}

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export * from "./types/supabase";
 export * from "./types/bounding_boxes";
 export * from "./types/events";
 export * from "./types/connectivity";
+export * from "./helpers/artifacts";
 export * from "./helpers/auth";
 export * from "./helpers/bounding_boxes";
 export * from "./helpers/chat";

package/dist/index.js

@@ -13,6 +13,7 @@ export * from "./types/bounding_boxes";
 export * from "./types/events";
 export * from "./types/connectivity";
 // Helpers
+export * from "./helpers/artifacts";
 export * from "./helpers/auth";
 export * from "./helpers/bounding_boxes";
 export * from "./helpers/chat";

package/dist/providers/ScoutRefreshProvider.d.ts

@@ -1637,6 +1637,65 @@ export declare function useSupabase(): SupabaseClient<Database, "public", "publi
             };
             Returns: string[];
         };
+        match_artifacts_by_vertex_embedding: {
+            Args: {
+                herd_id_caller?: number;
+                match_count: number;
+                match_threshold: number;
+                query_embedding: string;
+            };
+            Returns: {
+                created_at: string;
+                device_id: number;
+                embedding_qwen_vl_2b: string | null;
+                embedding_vertex_mm_01: string | null;
+                file_path: string;
+                id: number;
+                modality: string | null;
+                session_id: number | null;
+                timestamp_observation: string | null;
+                timestamp_observation_end: string;
+                updated_at: string | null;
+            }[];
+            SetofOptions: {
+                from: "*";
+                to: "artifacts";
+                isOneToOne: false;
+                isSetofReturn: true;
+            };
+        };
+        match_events_by_vertex_embedding: {
+            Args: {
+                herd_id_caller?: number;
+                match_count: number;
+                match_threshold: number;
+                query_embedding: string;
+            };
+            Returns: {
+                altitude: number;
+                device_id: number;
+                earthranger_url: string | null;
+                embedding_qwen_vl_2b: string | null;
+                embedding_vertex_mm_01: string | null;
+                file_path: string | null;
+                heading: number;
+                id: number;
+                inserted_at: string;
+                is_public: boolean;
+                location: unknown;
+                media_type: Database["public"]["Enums"]["media_type"];
+                media_url: string | null;
+                message: string | null;
+                session_id: number | null;
+                timestamp_observation: string;
+            }[];
+            SetofOptions: {
+                from: "*";
+                to: "events";
+                isOneToOne: false;
+                isSetofReturn: true;
+            };
+        };
         remove_rls_broadcast_triggers: {
             Args: never;
             Returns: undefined;

package/dist/types/db.d.ts

@@ -58,6 +58,7 @@ export type ISessionUsageOverTime = Database["public"]["Functions"]["get_session
 export type PartInsert = Database["public"]["Tables"]["parts"]["Insert"];
 export type VersionsSoftwareInsert = Database["public"]["Tables"]["versions_software"]["Insert"];
 export type ArtifactInsert = Database["public"]["Tables"]["artifacts"]["Insert"];
+export type ArtifactUpdate = Database["public"]["Tables"]["artifacts"]["Update"];
 export type PinInsert = Database["public"]["Tables"]["pins"]["Insert"];
 export type SessionInsert = Database["public"]["Tables"]["sessions"]["Insert"];
 export type SessionUpdate = Database["public"]["Tables"]["sessions"]["Update"];

package/dist/types/supabase.d.ts

@@ -1693,6 +1693,65 @@ export type Database = {
                 };
                 Returns: string[];
             };
+            match_artifacts_by_vertex_embedding: {
+                Args: {
+                    herd_id_caller?: number;
+                    match_count: number;
+                    match_threshold: number;
+                    query_embedding: string;
+                };
+                Returns: {
+                    created_at: string;
+                    device_id: number;
+                    embedding_qwen_vl_2b: string | null;
+                    embedding_vertex_mm_01: string | null;
+                    file_path: string;
+                    id: number;
+                    modality: string | null;
+                    session_id: number | null;
+                    timestamp_observation: string | null;
+                    timestamp_observation_end: string;
+                    updated_at: string | null;
+                }[];
+                SetofOptions: {
+                    from: "*";
+                    to: "artifacts";
+                    isOneToOne: false;
+                    isSetofReturn: true;
+                };
+            };
+            match_events_by_vertex_embedding: {
+                Args: {
+                    herd_id_caller?: number;
+                    match_count: number;
+                    match_threshold: number;
+                    query_embedding: string;
+                };
+                Returns: {
+                    altitude: number;
+                    device_id: number;
+                    earthranger_url: string | null;
+                    embedding_qwen_vl_2b: string | null;
+                    embedding_vertex_mm_01: string | null;
+                    file_path: string | null;
+                    heading: number;
+                    id: number;
+                    inserted_at: string;
+                    is_public: boolean;
+                    location: unknown;
+                    media_type: Database["public"]["Enums"]["media_type"];
+                    media_url: string | null;
+                    message: string | null;
+                    session_id: number | null;
+                    timestamp_observation: string;
+                }[];
+                SetofOptions: {
+                    from: "*";
+                    to: "events";
+                    isOneToOne: false;
+                    isSetofReturn: true;
+                };
+            };
             remove_rls_broadcast_triggers: {
                 Args: never;
                 Returns: undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adventurelabs/scout-core",
-  "version": "1.4.13",
+  "version": "1.4.15",
   "description": "Core utilities and helpers for Adventure Labs Scout applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",