@evercam/api 1.0.0-3bfceb83d → 1.0.0-3c7f69373

package/dist/api/types/observationEvents.d.ts

@@ -1,3 +1,4 @@
+import type { VisionProvider } from "@evercam/api/types";
 export declare enum ObservationEventStatus {
     Detected = "detected",
     Approved = "approved",
@@ -13,6 +14,13 @@ export interface ObservationEventStatusConfig {
 export declare const OBSERVATION_EVENT_STATUS_CONFIGS: Record<ObservationEventStatus, ObservationEventStatusConfig>;
 export interface SiteAnalyticsObservationEvent {
     id: number;
+    sourceType?: ObservationSourceType;
+    sessionId?: string | null;
+    markerId?: string | null;
+    drawingId?: string | null;
+    drawingName?: string | null;
+    walkName?: string | null;
+    sightings?: Array<Record<string, unknown>> | null;
     observationTypeId: number;
     observationName: string | null;
     observationCode: string | null;
@@ -27,7 +35,7 @@ export interface SiteAnalyticsObservationEvent {
     model: string | null;
     promptId: number | null;
     observationMetadata: Record<string, unknown> | null;
-    trigger: string;
+    trigger: ObservationEventTrigger | string;
     reviewedBy: string | null;
     reviewedAt: string | null;
     insertedAt: string;
@@ -37,11 +45,17 @@ export type ObservationEventQueryParams = {
     projectExid?: string;
     observationTypeIds?: string;
     status?: ObservationEventStatus | string;
+    sourceType?: ObservationSourceType | string;
+    modelName?: string;
     sortBy?: string;
     sortDir?: "asc" | "desc";
     page?: number;
     limit?: number;
 };
+export interface ObservationModelOption {
+    modelName: string;
+    total: number;
+}
 export interface ObservationEventListResponse {
     items: SiteAnalyticsObservationEvent[];
     total: number;
@@ -59,3 +73,69 @@ export interface ObservationEventReviewResponse {
     id: number | string;
     message: string;
 }
+export declare enum ObservationSourceType {
+    Camera = "camera",
+    Walk360 = "walk360",
+    Drone = "drone"
+}
+export declare enum ObservationEventTrigger {
+    CameraDetection = "camera_detection",
+    Walk = "walk"
+}
+export declare enum Walk360ProcessedSessionStatus {
+    Done = "done",
+    Processing = "processing",
+    Retryable = "retryable",
+    Error = "error"
+}
+export interface Walk360Activity {
+    observationTypeId: number;
+}
+export interface Walk360WorkerInfo {
+    coolifyAppId?: string | null;
+    workerStatus?: string | null;
+    workerIsRunning?: boolean;
+    appUrl?: string | null;
+    visionProvider?: VisionProvider;
+}
+export interface Walk360Config extends Walk360WorkerInfo {
+    projectExid: string;
+    enabled: boolean;
+    startDate: string | null;
+    activities: Walk360Activity[];
+    configured: boolean;
+    maxParallelWalks?: number;
+}
+export interface Walk360ConfigSummary extends Walk360WorkerInfo {
+    projectExid: string;
+    projectName?: string | null;
+    enabled: boolean;
+    startDate: string | null;
+    activities: Walk360Activity[];
+    maxParallelWalks: number;
+    walksDone: number;
+    walksProcessing: number;
+    walksRetryable: number;
+    eventsCreated: number;
+    lastProcessedAt: string | null;
+    updatedAt: string | null;
+}
+export interface Walk360WorkerAction {
+    projectExid: string;
+    appUuid: string | null;
+    message: string;
+    state: string;
+}
+export interface Walk360ProcessedSession {
+    id: number;
+    projectExid: string;
+    sourceType: ObservationSourceType;
+    sessionId: string;
+    status: Walk360ProcessedSessionStatus;
+    markersTotal: number | null;
+    markersProcessed: number | null;
+    eventsCreated: number | null;
+    error: string | null;
+    startedAt: string;
+    finishedAt: string | null;
+}

package/dist/api/types/observations.d.ts

@@ -1,42 +1,46 @@
-import { type ProjectExid, type CameraExid, type DateType, type BBox, PpeLabel, DownloadFileType } from "@evercam/api/types";
-export declare enum ObservationItemState {
-    Absent = 0,
-    Present = 1,
-    NotVisible = 2
-}
-export type ObservationEventEquipment = {
-    score: number;
-    bbox: BBox;
-};
+import { type ProjectExid, type CameraExid, type DateType, type BBox, AiObservationFeasibilityStatus, ObservationEventStatus, DownloadFileType } from "@evercam/api/types";
+export type ObservationApproval = boolean | ObservationEventStatus.Unsure | null;
 export type ObservationEvent = {
     id: number;
+    observationTypeId: number;
+    observationCode: string | null;
     cameraExid: CameraExid;
-    projectExid: ProjectExid;
+    projectExid: ProjectExid | null;
     capturedAt: DateType;
-    personIndex: number;
-    personBbox: BBox;
-    personScore: number;
-    ppe: Partial<Record<PpeLabel, ObservationEventEquipment>>;
-    hasHelmet: ObservationItemState | null;
-    hasHighVisVest: ObservationItemState | null;
-    hasGloves: ObservationItemState | null;
-    hasGlasses: ObservationItemState | null;
-    modelVersion: string;
-    createdAt: DateType;
-    compliant: boolean;
+    endTime: DateType | null;
+    confidence: number | null;
+    status: ObservationEventStatus;
+    isApproved: ObservationApproval;
     reason: string | null;
-    isApproved: boolean | null;
+    personBbox: BBox | null;
+    modelVersion: string | null;
+    observationMetadata: Record<string, unknown> | null;
+    trigger: string;
+    reviewedBy: string | null;
+    reviewedAt: DateType | null;
 };
+export type ObservationType = {
+    id: number;
+    observationCode: string;
+    name: string;
+    description: string | null;
+    type: string;
+    severity: number | null;
+    feasibilityStatus: AiObservationFeasibilityStatus;
+};
+export declare enum ObservationMissingItem {
+    Helmet = "helmet",
+    HighVisVest = "high_vis_vest",
+    Gloves = "gloves",
+    Glasses = "glasses"
+}
 export type ObservationEventsQueryParams = {
     cameraExid?: CameraExid;
+    observationCode?: string;
     fromDate?: string;
     toDate?: string;
-    required?: string;
-    compliant?: boolean;
-    hasHelmet?: boolean;
-    hasHighVisVest?: boolean;
-    hasGloves?: boolean;
-    hasGlasses?: boolean;
+    missingItems?: string;
+    status?: ObservationEventStatus;
     sort?: string;
     page?: number;
     limit?: number;
@@ -63,21 +67,16 @@ export declare enum ObservationCountsGranularity {
 }
 export type ObservationEventsCountsQueryParams = {
     cameraExid?: CameraExid;
+    observationCode?: string;
     fromDate?: string;
     toDate?: string;
-    required?: string;
-    compliant?: boolean;
-    hasHelmet?: boolean;
-    hasHighVisVest?: boolean;
-    hasGloves?: boolean;
-    hasGlasses?: boolean;
+    missingItems?: string;
+    status?: ObservationEventStatus;
     granularity?: ObservationCountsGranularity;
 };
 export type ObservationEventCount = {
     bucket: DateType;
     total: number;
-    compliant: number;
-    nonCompliant: number;
 };
 export declare enum ObservationRequiredItem {
     Helmet = "has_helmet",

package/dist/api/types/planner.d.ts

@@ -29,6 +29,7 @@ export declare enum PlannerUrlParams {
     DealId = "deal_id"
 }
 export declare enum EDistortImageModes {
+    Edit = "edit",
     FreeRotate = "freeRotate",
     Lock = "lock",
     Rotate = "rotate",

package/dist/api/types/project.d.ts

@@ -96,10 +96,10 @@ export declare enum ProjectFeatureFlag {
     MediaHubSharing = "archives_sharing",
     GateReportAnprBased = "anpr_sourced",
     NoLicensePlate = "no_license_plate",
-    DefaultToProjectApp = "default_to_project_app",
     SmartSearch = "smart_search",
     PpeMonitoring = "ppe_monitoring",
-    NoGdpr = "no_gdpr"
+    NoGdpr = "no_gdpr",
+    Chat = "chat"
 }
 export type ProjectBatteryReading = {
     exid: number;
@@ -230,6 +230,11 @@ export type ProjectUsersResponsePayload = {
     invites: ProjectInvite[];
     errors: ProjectUserError[];
 };
+export type MentionableUser = {
+    id: number;
+    fullname: string;
+    email: string;
+};
 export type ProjectStorageQueryParams = PaginationParams & {
     cameraName: string;
     cameraExid: CameraExid;

package/dist/api/types/shared.d.ts

@@ -109,25 +109,23 @@ export declare enum InfoPage {
     DroneView = "drone-view",
     Compare = "compare",
     Timeline = "timeline",
-    WeatherReport = "weather-report"
+    WeatherReport = "weather-report",
+    Cameras = "cameras"
 }
 export declare enum DownloadFileType {
     Jpeg = "jpeg",
     Pdf = "pdf",
     Csv = "csv"
 }
-export declare enum FeedbackContext {
-    CopilotMessage = "copilot_message"
+export type Stringified<T> = string & {
+    [P in keyof T]: {
+        "_ value": T[P];
+    };
+};
+export interface JSON {
+    stringify<T>(value: T, replacer?: (key: string, value: unknown) => unknown, space?: string | number): string & Stringified<T>;
+    parse<T>(text: Stringified<T>, reviver?: (key: unknown, value: unknown) => unknown): T;
 }
-export type FeedbackPayload = {
-    id?: number;
-    user: string;
-    text: string;
-    type: string;
-    context: FeedbackContext;
-    messageId?: number;
-    conversationId?: number;
-};
 export type TuplePoint2D = [number, number];
 export type TuplePoint3D = [number, number, number];
 export type Point2D = {

package/dist/api/types/siteAnalyticsManagement.d.ts

@@ -1,4 +1,12 @@
 import { CameraExid, DateType, PaginationParams, ProjectExid } from "@evercam/api/types";
+export declare enum VisionProvider {
+    Gemini = "gemini",
+    Gemma = "gemma"
+}
+export declare const VISION_PROVIDER_OPTIONS: {
+    text: string;
+    value: VisionProvider;
+}[];
 export type SiteAnalyticsCoolifyStatus = {
     appUuid: string | null;
     name: string | null;
@@ -38,6 +46,7 @@ export type SiteAnalyticsManagedApp = {
     skipWeekends: boolean;
     tracking: boolean;
     observations: boolean;
+    visionProvider?: VisionProvider | null;
     insertedAt: DateType | null;
     updatedAt: DateType | null;
     coolify: SiteAnalyticsCoolifyStatus | null;
@@ -62,6 +71,7 @@ export type CreateSiteAnalyticsAppPayload = {
     tracking?: boolean;
     observations?: boolean;
     observationPromptId?: number | null;
+    visionProvider?: VisionProvider;
 };
 export type UpdateSiteAnalyticsAppPayload = Partial<Omit<CreateSiteAnalyticsAppPayload, "projectExid" | "cameraExid" | "coolifyServerUuid">>;
 export type ModelOption = {

package/dist/api/types/siteView.d.ts

@@ -23,6 +23,7 @@ export type ForgeUrn = {
     displayName: string;
     urn: string;
     isModelHostedByEvercamACC?: boolean;
+    savedViews?: Record<string, ForgeView>;
 };
 export type ForgeAccAlignmentData = {
     bbox: {
@@ -30,6 +31,11 @@ export type ForgeAccAlignmentData = {
         max: Point2D;
     };
     transform: number[];
+    coordinateSystem?: {
+        context?: {
+            type?: string;
+        };
+    } | null;
 };
 export type TimelineItem = {
     taskNumber: number;
@@ -55,7 +61,6 @@ export type ForgeProjectData = {
     urns?: ForgeUrn[];
     accDrawingsAlignments?: Record<string, ForgeAccAlignmentData>;
     timeline?: TimelineItem[];
-    savedView?: ForgeView;
     markers?: ForgeMarker[];
 };
 export type ItwinModel = {

package/dist/api/types/user.d.ts

@@ -151,6 +151,21 @@ export type SessionsListRequestPayload = {
     limit: number;
     page: number;
 };
+export type AuthorizedApp = {
+    id: number;
+    clientId: string;
+    clientName: string;
+    clientDescription: string | null;
+    logoUrl: string | null;
+    scopes: string[];
+    grantedAt: string;
+};
+export type AuthorizedAppsListRequestPayload = {
+    search?: string;
+    sort?: string;
+    limit?: number;
+    page?: number;
+};
 export type SessionActivityCamSettingsDetail = {
     new: any;
     old: any;

package/dist/api/types/workflows.d.ts

@@ -0,0 +1,108 @@
+/**
+ * The Evercam Workflows engine (evercam-agent-kit), as the admin app sees it.
+ *
+ * These mirror `evercam_workflows/api/schemas.py`. The engine speaks camelCase over
+ * the wire, so the admin client reads it with `preserveCasing: true` and these are
+ * the shapes as received. Named `Chat*`, after the product; the Vue 3 agent app's
+ * own workflow types live in `packages/agent`, unreachable here.
+ */
+/** What kind of conversation this is. Chat only ever opens `chat`. */
+export declare enum ChatMode {
+    Workflow = "workflow",
+    Chat = "chat"
+}
+/** Whose conversations a list covers. Only an admin is ever given `all`. */
+export declare enum ChatScope {
+    Mine = "mine",
+    Account = "account",
+    All = "all"
+}
+/** A flat token tally, as the engine reports it. */
+export type ChatUsage = {
+    inputTokens?: number;
+    outputTokens?: number;
+    cacheCreationInputTokens?: number;
+    cacheReadInputTokens?: number;
+};
+/** One recorded tool step in a turn's trace, compacted by the engine. */
+export type ChatTraceStep = {
+    step?: number | null;
+    tool?: string | null;
+    result?: string | null;
+    durationMs?: number | null;
+    usage?: ChatUsage | null;
+    args?: unknown;
+};
+/** One stored turn, as the engine returns it inside a conversation. */
+export type ChatTurn = {
+    id: string;
+    userText?: string | null;
+    assistantText?: string | null;
+    thinkingSummary?: string | null;
+    artifact?: unknown;
+    /** The agent's tool steps for this answer. Absent on turns stored before traces. */
+    trace?: ChatTraceStep[] | null;
+    /** This turn's own token usage. */
+    usage?: ChatUsage | null;
+    runId?: string | null;
+    at?: string | null;
+};
+/** A conversation in full, with its transcript, cost ledger and per-turn traces. */
+export type ChatSession = {
+    id: string;
+    environment: string;
+    mode: string;
+    title: string | null;
+    projectExid: string | null;
+    projectName: string | null;
+    cameraExids: string[] | null;
+    turns: ChatTurn[];
+    savedWorkflowId: string | null;
+    createdBy: string | null;
+    createdAt: string;
+    updatedAt: string;
+    usage?: ChatUsage | null;
+    usageByModel?: Record<string, ChatUsage> | null;
+    model?: string | null;
+    /** Money as a string, or `null` (never `0`) when the conversation is unpriced. */
+    costUsd?: string | null;
+    priceBasis?: Record<string, unknown> | null;
+};
+/** One conversation as a list row — metadata and cost, without the transcript. */
+export type ChatSummary = {
+    id: string;
+    environment: string;
+    mode: string;
+    title: string | null;
+    projectExid: string | null;
+    projectName: string | null;
+    cameraExids: string[] | null;
+    createdBy: string | null;
+    createdAt: string;
+    updatedAt: string;
+    turnCount: number;
+    usage?: ChatUsage | null;
+    model?: string | null;
+    costUsd?: string | null;
+};
+/** A page of conversations for the admin viewer. */
+export type ChatListPage = {
+    chats: ChatSummary[];
+    total: number;
+    /** The scope the engine actually applied. */
+    scope: ChatScope;
+};
+/** Query params the admin conversations list accepts. */
+export type ChatListParams = {
+    scope?: ChatScope;
+    mode?: ChatMode;
+    projectExid?: string;
+    createdBy?: string;
+    q?: string;
+    from?: string;
+    to?: string;
+    sort?: string;
+    direction?: "asc" | "desc";
+    offset?: number;
+    limit?: number;
+};

package/dist/api/utils.d.ts

@@ -7,3 +7,4 @@ export declare const toQueryString: <T extends Record<string, unknown>>(paramsOb
     forceArrayBrackets?: boolean | undefined;
 }) => string | undefined;
 export declare function queryStringToObject(queryString?: string): QueryParams;
+export declare function getMediaApiPreviewName(url?: string | null): string | null;