@elevasis/ui 2.38.2 → 2.39.0

package/dist/hooks/index.d.ts

@@ -5,6 +5,40 @@ import * as react from 'react';
 import * as zustand_middleware from 'zustand/middleware';
 import * as zustand from 'zustand';
 
+/**
+ * Branded organization identifiers.
+ *
+ * Every organization carries TWO distinct ID values that are both plain
+ * strings at runtime but mean different things:
+ *
+ * - WorkOS organization id (`org_...`) -- the auth/JWT identity. Used for API
+ *   requests, SSE headers, and org-scoped query keys.
+ * - Supabase organization id (UUID) -- the database key. Used for
+ *   `.eq('organization_id', ...)` queries and RLS scoping.
+ *
+ * They are not interchangeable, yet both are `string` -- so a swap compiles
+ * cleanly and fails silently (zero rows on the Supabase side, cross-pollinated
+ * cache keys on the API side). These brands make the two non-assignable to one
+ * another, turning that silent footgun into a compile error at the sink.
+ *
+ * Mint a brand only through the `as*` factories below: they are the single
+ * validate-and-tag boundary (compile-time brand + runtime format check). The
+ * type predicates double as the cast, so no raw `as` cast is needed anywhere.
+ *
+ * Lives on the published `@repo/core` / `@repo/core/auth` surface so the UI,
+ * the API, and the dogfooding `@repo/elevasis-*` packages can all use it.
+ */
+declare const supabaseOrgIdBrand: unique symbol;
+declare const workOsOrgIdBrand: unique symbol;
+/** A Supabase organization id (UUID) -- the database key for RLS-scoped rows. */
+type SupabaseOrgId = string & {
+    readonly [supabaseOrgIdBrand]: true;
+};
+/** A WorkOS organization id (`org_...`) -- the auth identity for API/SSE/query keys. */
+type WorkOsOrgId = string & {
+    readonly [workOsOrgIdBrand]: true;
+};
+
 /**
  * Canonical permission catalog.
  *
@@ -3413,6 +3447,17 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
 }, z.core.$strip>>;
 type OntologyScope = z.infer<typeof OntologyScopeSchema>;
 
+declare const SystemApiInterfaceSchema: z.ZodObject<{
+    lifecycle: z.ZodDefault<z.ZodEnum<{
+        active: "active";
+        deprecated: "deprecated";
+        draft: "draft";
+        archived: "archived";
+        disabled: "disabled";
+    }>>;
+    readinessProfile: z.ZodOptional<z.ZodString>;
+    resourceIds: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+}, z.core.$strict>;
 type JsonPrimitive = string | number | boolean | null;
 type JsonValue = JsonPrimitive | JsonValue[] | {
     [key: string]: JsonValue;
@@ -3441,6 +3486,7 @@ interface SystemEntry {
     }[];
     policies?: string[];
     drivesGoals?: string[];
+    apiInterface?: z.infer<typeof SystemApiInterfaceSchema>;
     /** @deprecated Use lifecycle. Accepted for one publish cycle. */
     status?: 'active' | 'deprecated' | 'archived';
     path?: string;
@@ -5599,19 +5645,6 @@ interface UseAccessResult extends AccessAnswer {
  */
 declare function useAccess(key: AccessKeyInput): UseAccessResult;
 
-/**
- * Query key factory for executions TanStack Query hooks.
- * Uses organization UUID (not name) for cache isolation.
- */
-declare const executionsKeys: {
-    all: readonly ["executions"];
-    resources: (orgId: string | null) => readonly ["executions", "resources", string | null];
-    resourceDefinition: (orgId: string | null, resourceId: string) => readonly ["executions", "definition", string | null, string];
-    executionsListBase: (orgId: string | null, resourceId: string) => readonly ["executions", "list", string | null, string];
-    executions: (orgId: string | null, resourceId: string, resourceStatus?: string, limit?: number, offset?: number) => readonly ["executions", "list", string | null, string, string, number | null, number];
-    execution: (orgId: string | null, resourceId: string, executionId: string) => readonly ["executions", "execution", string | null, string, string];
-};
-
 type ExecutionStatus = 'pending' | 'running' | 'completed' | 'failed' | 'warning';
 /**
  * Event sent when new execution starts
@@ -5691,128 +5724,6 @@ interface APIExecutionListResponse {
     hasMore?: boolean;
 }
 
-/**
- * Execution history item.
- * Represents a single execution triggered by a schedule.
- */
-declare const ExecutionHistoryItemSchema: z.ZodObject<{
-    id: z.ZodString;
-    createdAt: z.ZodString;
-    status: z.ZodEnum<{
-        completed: "completed";
-        failed: "failed";
-        running: "running";
-        cancelled: "cancelled";
-    }>;
-    step: z.ZodNullable<z.ZodNumber>;
-    itemLabel: z.ZodNullable<z.ZodString>;
-    duration: z.ZodNullable<z.ZodNumber>;
-    error: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>;
-/**
- * Execution history response.
- * Returned by GET /schedules/:id/executions with pagination.
- */
-declare const ExecutionHistoryResponseSchema: z.ZodObject<{
-    executions: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        createdAt: z.ZodString;
-        status: z.ZodEnum<{
-            completed: "completed";
-            failed: "failed";
-            running: "running";
-            cancelled: "cancelled";
-        }>;
-        step: z.ZodNullable<z.ZodNumber>;
-        itemLabel: z.ZodNullable<z.ZodString>;
-        duration: z.ZodNullable<z.ZodNumber>;
-        error: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>>;
-    total: z.ZodNumber;
-    limit: z.ZodNumber;
-    offset: z.ZodNumber;
-}, z.core.$strip>;
-type ExecutionHistoryItem = z.infer<typeof ExecutionHistoryItemSchema>;
-type ExecutionHistoryResponse = z.infer<typeof ExecutionHistoryResponseSchema>;
-
-/**
- * Fetch the execution list for a given resource.
- *
- * @example
- * const { data, isLoading } = useExecutions(resourceId)
- *
- * @example
- * // With status filter and limit
- * const { data } = useExecutions(resourceId, 'running', 20)
- */
-declare function useExecutions(resourceId: string, resourceStatus?: ResourceStatus | 'all', limit?: number, offset?: number): _tanstack_react_query.UseQueryResult<APIExecutionListResponse, Error>;
-
-interface UseInFlightExecutionsOptions {
-    enabled?: boolean;
-    refetchInterval?: number | false;
-    limit?: number;
-    offset?: number;
-    listId?: string;
-}
-declare function useInFlightExecutions(resourceId: string, options?: UseInFlightExecutionsOptions): _tanstack_react_query.UseQueryResult<APIExecutionListResponse, Error>;
-
-/**
- * Fetch a single execution detail.
- * Automatically polls every 2 seconds while the execution status is 'running'.
- *
- * @example
- * const { data: execution, isLoading } = useExecution(resourceId, executionId)
- */
-declare function useExecution(resourceId: string, executionId: string): _tanstack_react_query.UseQueryResult<APIExecutionDetail, Error>;
-
-interface ExecuteAsyncParams {
-    resourceId: string;
-    resourceType: ResourceType;
-    input: unknown;
-    listId?: string;
-}
-interface ExecuteAsyncResult {
-    executionId: string;
-    status: string;
-    resourceId: string;
-}
-/**
- * Trigger an async execution for a workflow or agent.
- * Invalidates the executions list on success so the new execution appears immediately.
- *
- * @example
- * const { mutate: execute, isPending } = useExecuteAsync()
- * execute({ resourceId, resourceType: 'workflow', input: { ... } })
- */
-declare function useExecuteAsync(): _tanstack_react_query.UseMutationResult<ExecuteAsyncResult, Error, ExecuteAsyncParams, unknown>;
-
-interface UseWorkflowExecutionOptions {
-    workflowId: string;
-    listId?: string;
-}
-interface WorkflowExecutionTriggerParams {
-    input: unknown;
-}
-interface UseWorkflowExecutionResult {
-    execute: (params: WorkflowExecutionTriggerParams) => Promise<ExecuteAsyncResult>;
-    executionId: string | null;
-    status: string | null;
-    isIdle: boolean;
-    isPending: boolean;
-    isSuccess: boolean;
-    isError: boolean;
-    error: Error | null;
-    data: ExecuteAsyncResult | undefined;
-    reset: () => void;
-}
-/**
- * List-builder-friendly wrapper around async workflow execution.
- *
- * Binds a workflow ID once, exposes a small trigger API, and refreshes both
- * platform execution lists and list execution history when a list ID is known.
- */
-declare function useWorkflowExecution({ workflowId, listId }: UseWorkflowExecutionOptions): UseWorkflowExecutionResult;
-
 /**
  * @deprecated Use TimeRange from '@elevasis/core' directly. Kept as alias for backward compatibility.
  */
@@ -5890,6 +5801,50 @@ interface Activity {
     createdAt: Date;
 }
 
+/**
+ * Execution history item.
+ * Represents a single execution triggered by a schedule.
+ */
+declare const ExecutionHistoryItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodString;
+    status: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        running: "running";
+        cancelled: "cancelled";
+    }>;
+    step: z.ZodNullable<z.ZodNumber>;
+    itemLabel: z.ZodNullable<z.ZodString>;
+    duration: z.ZodNullable<z.ZodNumber>;
+    error: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Execution history response.
+ * Returned by GET /schedules/:id/executions with pagination.
+ */
+declare const ExecutionHistoryResponseSchema: z.ZodObject<{
+    executions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        createdAt: z.ZodString;
+        status: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            running: "running";
+            cancelled: "cancelled";
+        }>;
+        step: z.ZodNullable<z.ZodNumber>;
+        itemLabel: z.ZodNullable<z.ZodString>;
+        duration: z.ZodNullable<z.ZodNumber>;
+        error: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    limit: z.ZodNumber;
+    offset: z.ZodNumber;
+}, z.core.$strip>;
+type ExecutionHistoryItem = z.infer<typeof ExecutionHistoryItemSchema>;
+type ExecutionHistoryResponse = z.infer<typeof ExecutionHistoryResponseSchema>;
+
 /**
  * Deployment types — browser-safe
  *
@@ -6051,6 +6006,97 @@ declare const ListCredentialsResponseSchema: z.ZodObject<{
 /** API response type for a single credential list item */
 type CredentialListItem = z.infer<typeof ListCredentialsResponseSchema>['credentials'][number];
 
+/**
+ * Query key factory for executions TanStack Query hooks.
+ * Uses organization UUID (not name) for cache isolation.
+ */
+declare const executionsKeys: {
+    all: readonly ["executions"];
+    resources: (orgId: WorkOsOrgId | null) => readonly ["executions", "resources", WorkOsOrgId | null];
+    resourceDefinition: (orgId: WorkOsOrgId | null, resourceId: string) => readonly ["executions", "definition", WorkOsOrgId | null, string];
+    executionsListBase: (orgId: WorkOsOrgId | null, resourceId: string) => readonly ["executions", "list", WorkOsOrgId | null, string];
+    executions: (orgId: WorkOsOrgId | null, resourceId: string, resourceStatus?: string, limit?: number, offset?: number) => readonly ["executions", "list", WorkOsOrgId | null, string, string, number | null, number];
+    execution: (orgId: WorkOsOrgId | null, resourceId: string, executionId: string) => readonly ["executions", "execution", WorkOsOrgId | null, string, string];
+};
+
+/**
+ * Fetch the execution list for a given resource.
+ *
+ * @example
+ * const { data, isLoading } = useExecutions(resourceId)
+ *
+ * @example
+ * // With status filter and limit
+ * const { data } = useExecutions(resourceId, 'running', 20)
+ */
+declare function useExecutions(resourceId: string, resourceStatus?: ResourceStatus | 'all', limit?: number, offset?: number): _tanstack_react_query.UseQueryResult<APIExecutionListResponse, Error>;
+
+interface UseInFlightExecutionsOptions {
+    enabled?: boolean;
+    refetchInterval?: number | false;
+    limit?: number;
+    offset?: number;
+    listId?: string;
+}
+declare function useInFlightExecutions(resourceId: string, options?: UseInFlightExecutionsOptions): _tanstack_react_query.UseQueryResult<APIExecutionListResponse, Error>;
+
+/**
+ * Fetch a single execution detail.
+ * Automatically polls every 2 seconds while the execution status is 'running'.
+ *
+ * @example
+ * const { data: execution, isLoading } = useExecution(resourceId, executionId)
+ */
+declare function useExecution(resourceId: string, executionId: string): _tanstack_react_query.UseQueryResult<APIExecutionDetail, Error>;
+
+interface ExecuteAsyncParams {
+    resourceId: string;
+    resourceType: ResourceType;
+    input: unknown;
+    listId?: string;
+}
+interface ExecuteAsyncResult {
+    executionId: string;
+    status: string;
+    resourceId: string;
+}
+/**
+ * Trigger an async execution for a workflow or agent.
+ * Invalidates the executions list on success so the new execution appears immediately.
+ *
+ * @example
+ * const { mutate: execute, isPending } = useExecuteAsync()
+ * execute({ resourceId, resourceType: 'workflow', input: { ... } })
+ */
+declare function useExecuteAsync(): _tanstack_react_query.UseMutationResult<ExecuteAsyncResult, Error, ExecuteAsyncParams, unknown>;
+
+interface UseWorkflowExecutionOptions {
+    workflowId: string;
+    listId?: string;
+}
+interface WorkflowExecutionTriggerParams {
+    input: unknown;
+}
+interface UseWorkflowExecutionResult {
+    execute: (params: WorkflowExecutionTriggerParams) => Promise<ExecuteAsyncResult>;
+    executionId: string | null;
+    status: string | null;
+    isIdle: boolean;
+    isPending: boolean;
+    isSuccess: boolean;
+    isError: boolean;
+    error: Error | null;
+    data: ExecuteAsyncResult | undefined;
+    reset: () => void;
+}
+/**
+ * List-builder-friendly wrapper around async workflow execution.
+ *
+ * Binds a workflow ID once, exposes a small trigger API, and refreshes both
+ * platform execution lists and list execution history when a list ID is known.
+ */
+declare function useWorkflowExecution({ workflowId, listId }: UseWorkflowExecutionOptions): UseWorkflowExecutionResult;
+
 interface FetchEventSourceWithTokenRefreshOptions {
     url: string;
     getToken: () => Promise<string | undefined>;
@@ -6270,12 +6316,12 @@ declare function useScheduledTasks(options?: UseScheduledTasksOptions): _tanstac
  * Uses organizationId (UUID) for tenant-scoped cache isolation.
  */
 declare const scheduleKeys: {
-    all: (orgId: string | null) => readonly ["schedules", string | null];
-    lists: (orgId: string | null) => readonly ["schedules", string | null, "list"];
-    list: (orgId: string | null, filters?: ListSchedulesFilters) => readonly ["schedules", string | null, "list", ListSchedulesFilters | undefined];
-    details: (orgId: string | null) => readonly ["schedules", string | null, "detail"];
-    detail: (orgId: string | null, id: string) => readonly ["schedules", string | null, "detail", string];
-    executions: (orgId: string | null, id: string) => readonly ["schedules", string | null, "detail", string, "executions"];
+    all: (orgId: WorkOsOrgId | null) => readonly ["schedules", WorkOsOrgId | null];
+    lists: (orgId: WorkOsOrgId | null) => readonly ["schedules", WorkOsOrgId | null, "list"];
+    list: (orgId: WorkOsOrgId | null, filters?: ListSchedulesFilters) => readonly ["schedules", WorkOsOrgId | null, "list", ListSchedulesFilters | undefined];
+    details: (orgId: WorkOsOrgId | null) => readonly ["schedules", WorkOsOrgId | null, "detail"];
+    detail: (orgId: WorkOsOrgId | null, id: string) => readonly ["schedules", WorkOsOrgId | null, "detail", string];
+    executions: (orgId: WorkOsOrgId | null, id: string) => readonly ["schedules", WorkOsOrgId | null, "detail", string, "executions"];
 };
 /**
  * Filters for list schedules query.
@@ -6490,7 +6536,7 @@ declare function useDeleteSchedule(): _tanstack_react_query.UseMutationResult<vo
  * @param organizationId - Supabase UUID for the current org (used as RLS filter)
  * @param enabled - Whether to open the subscription (route-gating)
  */
-declare function useActivitiesRealtime(organizationId: string, enabled: boolean): void;
+declare function useActivitiesRealtime(organizationId: SupabaseOrgId | null, enabled: boolean): void;
 
 declare const projectActivityKeys: {
     all: readonly ["project-activities"];
@@ -6663,21 +6709,21 @@ declare function useNotificationCount(args: UseNotificationCountArgs): {
  */
 declare const observabilityKeys: {
     all: readonly ["observability"];
-    errorAnalysis: (organizationId: string | null, timeRange: string) => readonly ["observability", "error-analysis", string | null, string];
-    errorDetails: (organizationId: string | null, filters: object) => readonly ["observability", "error-details", string | null, object];
-    errorDetail: (organizationId: string | null, executionId: string | null) => readonly ["observability", "error-detail", string | null, string | null];
-    errorTrends: (organizationId: string | null, startDate: string, endDate: string, granularity: string) => readonly ["observability", "error-trends", string | null, string, string, string];
-    errorDistribution: (organizationId: string | null, startDate: string, endDate: string, groupBy: string) => readonly ["observability", "error-distribution", string | null, string, string, string];
-    topFailingResources: (organizationId: string | null, startDate: string, endDate: string, limit: number) => readonly ["observability", "top-failing-resources", string | null, string, string, number];
-    costTrends: (organizationId: string | null, timeRange: string, granularity: string) => readonly ["observability", "cost-trends", string | null, string, string];
-    costByModel: (organizationId: string | null, timeRange: string) => readonly ["observability", "cost-by-model", string | null, string];
-    costBreakdown: (organizationId: string | null, timeRange: string) => readonly ["observability", "cost-breakdown", string | null, string];
-    dashboardMetrics: (organizationId: string | null, timeRange: string) => readonly ["observability", "dashboard-metrics", string | null, string];
-    businessImpact: (organizationId: string | null, timeRange: string) => readonly ["observability", "business-impact", string | null, string];
-    resourcesHealth: (organizationId: string | null, resources: string, startDate: string, endDate: string, granularity: string) => readonly ["observability", "resources-health", string | null, string, string, string, string];
-    systemHealth: (organizationId: string | null, systemPath: string, timeRange: string, includeDescendants: boolean, descendantMode: string, resourceSet: string, startDate: string, endDate: string, directResources: readonly unknown[], descendantResources: readonly unknown[]) => readonly ["observability", "system-health", string | null, string, string, boolean, string, string, string, string, readonly unknown[], readonly unknown[]];
-    unresolvedErrors: (organizationId: string | null, startDate: string, endDate: string) => readonly ["observability", "unresolved-errors", string | null, string, string];
-    recentExecutionsByResource: (organizationId: string | null, timeRange: string, limit: number | undefined) => readonly ["observability", "recent-executions-by-resource", string | null, string, number | undefined];
+    errorAnalysis: (organizationId: WorkOsOrgId | null, timeRange: string) => readonly ["observability", "error-analysis", WorkOsOrgId | null, string];
+    errorDetails: (organizationId: WorkOsOrgId | null, filters: object) => readonly ["observability", "error-details", WorkOsOrgId | null, object];
+    errorDetail: (organizationId: WorkOsOrgId | null, executionId: string | null) => readonly ["observability", "error-detail", WorkOsOrgId | null, string | null];
+    errorTrends: (organizationId: WorkOsOrgId | null, startDate: string, endDate: string, granularity: string) => readonly ["observability", "error-trends", WorkOsOrgId | null, string, string, string];
+    errorDistribution: (organizationId: WorkOsOrgId | null, startDate: string, endDate: string, groupBy: string) => readonly ["observability", "error-distribution", WorkOsOrgId | null, string, string, string];
+    topFailingResources: (organizationId: WorkOsOrgId | null, startDate: string, endDate: string, limit: number) => readonly ["observability", "top-failing-resources", WorkOsOrgId | null, string, string, number];
+    costTrends: (organizationId: WorkOsOrgId | null, timeRange: string, granularity: string) => readonly ["observability", "cost-trends", WorkOsOrgId | null, string, string];
+    costByModel: (organizationId: WorkOsOrgId | null, timeRange: string) => readonly ["observability", "cost-by-model", WorkOsOrgId | null, string];
+    costBreakdown: (organizationId: WorkOsOrgId | null, timeRange: string) => readonly ["observability", "cost-breakdown", WorkOsOrgId | null, string];
+    dashboardMetrics: (organizationId: WorkOsOrgId | null, timeRange: string) => readonly ["observability", "dashboard-metrics", WorkOsOrgId | null, string];
+    businessImpact: (organizationId: WorkOsOrgId | null, timeRange: string) => readonly ["observability", "business-impact", WorkOsOrgId | null, string];
+    resourcesHealth: (organizationId: WorkOsOrgId | null, resources: string, startDate: string, endDate: string, granularity: string) => readonly ["observability", "resources-health", WorkOsOrgId | null, string, string, string, string];
+    systemHealth: (organizationId: WorkOsOrgId | null, systemPath: string, timeRange: string, includeDescendants: boolean, descendantMode: string, resourceSet: string, startDate: string, endDate: string, directResources: readonly unknown[], descendantResources: readonly unknown[]) => readonly ["observability", "system-health", WorkOsOrgId | null, string, string, boolean, string, string, string, string, readonly unknown[], readonly unknown[]];
+    unresolvedErrors: (organizationId: WorkOsOrgId | null, startDate: string, endDate: string) => readonly ["observability", "unresolved-errors", WorkOsOrgId | null, string, string];
+    recentExecutionsByResource: (organizationId: WorkOsOrgId | null, timeRange: string, limit: number | undefined) => readonly ["observability", "recent-executions-by-resource", WorkOsOrgId | null, string, number | undefined];
 };
 
 declare function useErrorAnalysis(timeRange: TimeRange): _tanstack_react_query.UseQueryResult<ErrorAnalysisMetrics, Error>;
@@ -7102,18 +7148,26 @@ declare function useSSEConnection({ manager, connectionKey, url, enabled, header
 /**
  * Session-scoped query key factory.
  * Organization identifier is always included for cache isolation.
+ *
+ * Keyed by the Supabase org UUID (`SupabaseOrgId`) — the stable discriminator used
+ * across all session hooks. (Previously keyed inconsistently: org name in the
+ * list/CRUD hooks vs Supabase UUID in the execution/message/WebSocket hooks, which
+ * caused a silent cache-invalidation mismatch — `useSessionWebSocket` invalidated
+ * `session(supabaseId, …)` while `useSession` cached under `session(orgName, …)`.
+ * Unified to the Supabase UUID on 2026-05-23; surfaced by the dual-org-ID brand.)
  */
+
 declare const sessionsKeys: {
     all: readonly ["sessions"];
-    sessions: (org: string, params?: {
+    sessions: (org: SupabaseOrgId | null, params?: {
         resourceId?: string;
-    }) => readonly ["sessions", "list", string, {
+    }) => readonly ["sessions", "list", SupabaseOrgId | null, {
         resourceId?: string;
     } | undefined];
-    session: (org: string, sessionId: string) => readonly ["sessions", "detail", string, string];
-    executions: (org: string, sessionId: string) => readonly ["sessions", string, string, "executions"];
-    execution: (org: string, sessionId: string, executionId: string) => readonly ["sessions", string, string, "executions", string];
-    messages: (org: string, sessionId: string) => readonly ["sessions", string, string, "messages"];
+    session: (org: SupabaseOrgId | null, sessionId: string) => readonly ["sessions", "detail", SupabaseOrgId | null, string];
+    executions: (org: SupabaseOrgId | null, sessionId: string) => readonly ["sessions", SupabaseOrgId | null, string, "executions"];
+    execution: (org: SupabaseOrgId | null, sessionId: string, executionId: string) => readonly ["sessions", SupabaseOrgId | null, string, "executions", string];
+    messages: (org: SupabaseOrgId | null, sessionId: string) => readonly ["sessions", SupabaseOrgId | null, string, "messages"];
 };
 
 interface SessionExecution {
@@ -7327,9 +7381,9 @@ interface RequestsListFilters {
 declare const requestsKeys: {
     all: readonly ["requests"];
     lists: () => readonly ["requests", "list"];
-    list: (organizationId: string | null | undefined, filters: RequestsListFilters) => readonly ["requests", "list", string | null | undefined, RequestsListFilters];
+    list: (organizationId: WorkOsOrgId | null | undefined, filters: RequestsListFilters) => readonly ["requests", "list", WorkOsOrgId | null | undefined, RequestsListFilters];
     details: () => readonly ["requests", "detail"];
-    detail: (organizationId: string | null | undefined, id: string | undefined) => readonly ["requests", "detail", string | null | undefined, string | undefined];
+    detail: (organizationId: WorkOsOrgId | null | undefined, id: string | undefined) => readonly ["requests", "detail", WorkOsOrgId | null | undefined, string | undefined];
 };
 
 type RequestRow = Database['public']['Tables']['reported_requests']['Row'];
@@ -7413,11 +7467,11 @@ interface ClientsListFilters {
 declare const clientsKeys: {
     all: readonly ["clients"];
     lists: () => readonly ["clients", "list"];
-    list: (organizationId: string | null | undefined, filters: ClientsListFilters) => readonly ["clients", "list", string | null | undefined, ClientsListFilters];
+    list: (organizationId: WorkOsOrgId | null | undefined, filters: ClientsListFilters) => readonly ["clients", "list", WorkOsOrgId | null | undefined, ClientsListFilters];
     statuses: () => readonly ["clients", "status"];
-    status: (organizationId: string | null | undefined) => readonly ["clients", "status", string | null | undefined];
+    status: (organizationId: WorkOsOrgId | null | undefined) => readonly ["clients", "status", WorkOsOrgId | null | undefined];
     details: () => readonly ["clients", "detail"];
-    detail: (organizationId: string | null | undefined, id: string | undefined) => readonly ["clients", "detail", string | null | undefined, string | undefined];
+    detail: (organizationId: WorkOsOrgId | null | undefined, id: string | undefined) => readonly ["clients", "detail", WorkOsOrgId | null | undefined, string | undefined];
 };
 
 declare function useClients(filters?: ClientsListFilters): _tanstack_react_query.UseQueryResult<{
@@ -7543,18 +7597,18 @@ declare function useDeleteClient(): _tanstack_react_query.UseMutationResult<void
 
 declare const operationsKeys: {
     all: readonly ["operations"];
-    workflows: (org?: string) => readonly ["operations", "workflows", string | undefined];
-    workflowDetails: (org?: string) => readonly ["operations", "workflows", string | undefined, "details"];
-    workflow: (id: string, org?: string) => readonly ["operations", "workflows", string | undefined, string];
-    agents: (org?: string) => readonly ["operations", "agents", string | undefined];
-    agentDetails: (org?: string) => readonly ["operations", "agents", string | undefined, "details"];
-    agent: (id: string, org?: string) => readonly ["operations", "agents", string | undefined, string];
-    sessions: (org: string, params?: {
+    workflows: (org?: WorkOsOrgId) => readonly ["operations", "workflows", WorkOsOrgId | undefined];
+    workflowDetails: (org?: WorkOsOrgId) => readonly ["operations", "workflows", WorkOsOrgId | undefined, "details"];
+    workflow: (id: string, org?: WorkOsOrgId) => readonly ["operations", "workflows", WorkOsOrgId | undefined, string];
+    agents: (org?: WorkOsOrgId) => readonly ["operations", "agents", WorkOsOrgId | undefined];
+    agentDetails: (org?: WorkOsOrgId) => readonly ["operations", "agents", WorkOsOrgId | undefined, "details"];
+    agent: (id: string, org?: WorkOsOrgId) => readonly ["operations", "agents", WorkOsOrgId | undefined, string];
+    sessions: (org: WorkOsOrgId, params?: {
         resourceId?: string;
-    }) => readonly ["operations", "sessions", string, {
+    }) => readonly ["operations", "sessions", WorkOsOrgId, {
         resourceId?: string;
     } | undefined];
-    session: (org: string, sessionId: string) => readonly ["operations", "session", string, string];
+    session: (org: WorkOsOrgId, sessionId: string) => readonly ["operations", "session", WorkOsOrgId, string];
 };
 
 interface UseExecutionPanelStateOptions {
@@ -7851,11 +7905,11 @@ interface UseDealsLookupOptions {
 declare const dealKeys: {
     all: readonly ["deals"];
     lists: () => readonly ["deals", "list"];
-    list: (orgId: string | null, filters: DealFilters) => readonly ["deals", "list", string | null, DealFilters];
+    list: (orgId: WorkOsOrgId | null, filters: DealFilters) => readonly ["deals", "list", WorkOsOrgId | null, DealFilters];
     summaries: () => readonly ["deals", "summary"];
-    summary: (orgId: string | null) => readonly ["deals", "summary", string | null];
+    summary: (orgId: WorkOsOrgId | null) => readonly ["deals", "summary", WorkOsOrgId | null];
     lookups: () => readonly ["deals", "lookup"];
-    lookup: (orgId: string | null, filters: DealLookupFilters) => readonly ["deals", "lookup", string | null, DealLookupFilters];
+    lookup: (orgId: WorkOsOrgId | null, filters: DealLookupFilters) => readonly ["deals", "lookup", WorkOsOrgId | null, DealLookupFilters];
     details: () => readonly ["deals", "detail"];
     detail: (id: string) => readonly ["deals", "detail", string];
 };
@@ -8088,7 +8142,7 @@ declare function useExecuteAction({ dealId }: {
  */
 declare const dealNoteKeys: {
     all: readonly ["deal-notes"];
-    list: (organizationId: string | null, dealId: string) => readonly ["deal-notes", string | null, string];
+    list: (organizationId: WorkOsOrgId | null, dealId: string) => readonly ["deal-notes", WorkOsOrgId | null, string];
 };
 /**
  * Fetch notes for a specific deal, newest-first.
@@ -8110,8 +8164,8 @@ declare function useCreateDealNote(): _tanstack_react_query.UseMutationResult<Ac
  */
 declare const dealTaskKeys: {
     all: readonly ["deal-tasks"];
-    list: (orgId: string | null, dealId: string) => readonly ["deal-tasks", string | null, string];
-    due: (orgId: string | null, window: string, assigneeUserId: string | null) => readonly ["deal-tasks-due", string | null, string, string | null];
+    list: (orgId: WorkOsOrgId | null, dealId: string) => readonly ["deal-tasks", WorkOsOrgId | null, string];
+    due: (orgId: WorkOsOrgId | null, window: string, assigneeUserId: string | null) => readonly ["deal-tasks-due", WorkOsOrgId | null, string, string | null];
 };
 /**
  * Fetch all tasks for a specific deal, ordered by due date ascending (nulls last).
@@ -8161,13 +8215,13 @@ declare function useCompleteDealTask(): _tanstack_react_query.UseMutationResult<
 
 declare const acquisitionListKeys: {
     all: readonly ["acquisition-lists"];
-    list: (organizationId: string | null) => readonly ["acquisition-lists", string | null];
-    detail: (organizationId: string | null, listId: string) => readonly ["acquisition-lists", string | null, string];
-    telemetry: (organizationId: string | null) => readonly ["acquisition-lists", "telemetry", string | null];
-    progress: (organizationId: string | null, listId: string) => readonly ["acquisition-lists", "progress", string | null, string];
-    executionsBase: (organizationId: string | null, listId: string) => readonly ["acquisition-lists", "executions", string | null, string];
-    records: (organizationId: string | null, listId: string, filters: ListRecordsFilters) => readonly ["acquisition-lists", "records", string | null, string, "company" | "contact", string | null, number | null, number | null];
-    executions: (organizationId: string | null, listId: string, filters?: ListExecutionsFilters) => readonly ["acquisition-lists", "executions", string | null, string, string | null, number | null];
+    list: (organizationId: WorkOsOrgId | null) => readonly ["acquisition-lists", WorkOsOrgId | null];
+    detail: (organizationId: WorkOsOrgId | null, listId: string) => readonly ["acquisition-lists", WorkOsOrgId | null, string];
+    telemetry: (organizationId: WorkOsOrgId | null) => readonly ["acquisition-lists", "telemetry", WorkOsOrgId | null];
+    progress: (organizationId: WorkOsOrgId | null, listId: string) => readonly ["acquisition-lists", "progress", WorkOsOrgId | null, string];
+    executionsBase: (organizationId: WorkOsOrgId | null, listId: string) => readonly ["acquisition-lists", "executions", WorkOsOrgId | null, string];
+    records: (organizationId: WorkOsOrgId | null, listId: string, filters: ListRecordsFilters) => readonly ["acquisition-lists", "records", WorkOsOrgId | null, string, "company" | "contact", string | null, number | null, number | null];
+    executions: (organizationId: WorkOsOrgId | null, listId: string, filters?: ListExecutionsFilters) => readonly ["acquisition-lists", "executions", WorkOsOrgId | null, string, string | null, number | null];
 };
 interface ListRecordsFilters {
     entity: ListRecordEntity;
@@ -8808,7 +8862,7 @@ interface AcqCompanyFacetsResponse {
 }
 declare const companyKeys: {
     all: readonly ["acquisition-companies"];
-    list: (organizationId: string | null, filters: Partial<ListCompaniesQuery>) => readonly ["acquisition-companies", "list", string | null, Partial<{
+    list: (organizationId: WorkOsOrgId | null, filters: Partial<ListCompaniesQuery>) => readonly ["acquisition-companies", "list", WorkOsOrgId | null, Partial<{
         limit: number;
         offset: number;
         search?: string | undefined;
@@ -8822,8 +8876,8 @@ declare const companyKeys: {
         status?: "active" | "invalid" | undefined;
         includeAll?: boolean | undefined;
     }>];
-    facets: (organizationId: string | null) => readonly ["acquisition-companies", "facets", string | null];
-    detail: (organizationId: string | null, companyId: string) => readonly ["acquisition-companies", "detail", string | null, string];
+    facets: (organizationId: WorkOsOrgId | null) => readonly ["acquisition-companies", "facets", WorkOsOrgId | null];
+    detail: (organizationId: WorkOsOrgId | null, companyId: string) => readonly ["acquisition-companies", "detail", WorkOsOrgId | null, string];
 };
 declare function useCompanies(filters?: Partial<ListCompaniesQuery>): _tanstack_react_query.UseQueryResult<{
     data: {
@@ -8994,7 +9048,7 @@ declare function useDeleteCompanies(): _tanstack_react_query.UseMutationResult<v
 type AcqContactWithCompany = AcqContactResponse;
 declare const contactKeys: {
     all: readonly ["acquisition-contacts"];
-    list: (organizationId: string | null, filters: Partial<ListContactsQuery>) => readonly ["acquisition-contacts", "list", string | null, Partial<{
+    list: (organizationId: WorkOsOrgId | null, filters: Partial<ListContactsQuery>) => readonly ["acquisition-contacts", "list", WorkOsOrgId | null, Partial<{
         limit: number;
         offset: number;
         search?: string | undefined;
@@ -9003,7 +9057,7 @@ declare const contactKeys: {
         batchId?: string | undefined;
         contactStatus?: "active" | "invalid" | undefined;
     }>];
-    detail: (organizationId: string | null, contactId: string) => readonly ["acquisition-contacts", "detail", string | null, string];
+    detail: (organizationId: WorkOsOrgId | null, contactId: string) => readonly ["acquisition-contacts", "detail", WorkOsOrgId | null, string];
 };
 declare function useContacts(filters?: Partial<ListContactsQuery>): _tanstack_react_query.UseQueryResult<{
     data: {
@@ -9201,7 +9255,7 @@ declare function useDeleteContacts(): _tanstack_react_query.UseMutationResult<vo
 
 declare const leadGenArtifactKeys: {
     all: readonly ["lead-gen-artifacts"];
-    list: (organizationId: string | null, ownerKind: AcqArtifactOwnerKind, ownerId: string) => readonly ["lead-gen-artifacts", string | null, "company" | "contact" | "list" | "deal" | "list_member", string];
+    list: (organizationId: WorkOsOrgId | null, ownerKind: AcqArtifactOwnerKind, ownerId: string) => readonly ["lead-gen-artifacts", WorkOsOrgId | null, "company" | "contact" | "list" | "deal" | "list_member", string];
 };
 interface UseArtifactsParams {
     ownerKind: AcqArtifactOwnerKind;
@@ -9242,8 +9296,8 @@ declare function useCreateArtifact(): _tanstack_react_query.UseMutationResult<{
 
 declare const leadGenListMemberKeys: {
     all: readonly ["lead-gen-list-members"];
-    list: (organizationId: string | null, listId: string) => readonly ["lead-gen-list-members", string | null, "list", string];
-    detail: (organizationId: string | null, memberId: string) => readonly ["lead-gen-list-members", string | null, "detail", string];
+    list: (organizationId: WorkOsOrgId | null, listId: string) => readonly ["lead-gen-list-members", WorkOsOrgId | null, "list", string];
+    detail: (organizationId: WorkOsOrgId | null, memberId: string) => readonly ["lead-gen-list-members", WorkOsOrgId | null, "detail", string];
 };
 declare function useListMembers({ listId }: {
     listId: string;
@@ -9307,7 +9361,7 @@ declare function useTransitionListMember(): _tanstack_react_query.UseMutationRes
 
 declare const leadGenListCompanyKeys: {
     all: readonly ["lead-gen-list-companies"];
-    detail: (organizationId: string | null, listCompanyId: string) => readonly ["lead-gen-list-companies", string | null, "detail", string];
+    detail: (organizationId: WorkOsOrgId | null, listCompanyId: string) => readonly ["lead-gen-list-companies", WorkOsOrgId | null, "detail", string];
 };
 interface TransitionListCompanyInput extends TransitionItemRequest {
     listCompanyId: string;
@@ -9717,10 +9771,13 @@ declare function useUpdateWebhookEndpoint(): _tanstack_react_query.UseMutationRe
  */
 interface ElevasisServiceContextValue {
     apiRequest: <T>(endpoint: string, options?: RequestInit) => Promise<T>;
-    /** Organization ID alias retained for existing query-key consumers. */
-    organizationId: string | null;
-    /** WorkOS `org_xxx` string for the current organization. */
-    workOSOrganizationId: string | null;
+    /**
+     * @deprecated Alias of `workOSOrganizationId` retained for existing query-key consumers.
+     * Resolves to the WorkOS `org_xxx` id (NOT the Supabase UUID). Prefer `workOSOrganizationId`.
+     */
+    organizationId: WorkOsOrgId | null;
+    /** WorkOS `org_xxx` id for the current organization. */
+    workOSOrganizationId: WorkOsOrgId | null;
     isReady: boolean;
 }