@elevasis/ui 1.3.4 → 1.3.5

package/dist/hooks/index.d.ts

@@ -1,11 +1,4401 @@
-export * from './command-queue';
-export * from './executions';
-export * from './monitoring';
-export * from './notifications';
-export * from './observability';
-export * from './scheduling';
-export * from './services';
-export * from './table';
-export * from './feature-access';
-export * from './sse';
-//# sourceMappingURL=index.d.ts.map
+import * as _tanstack_react_query from '@tanstack/react-query';
+import * as react from 'react';
+import { z } from 'zod';
+
+/**
+ * Error categories for observability grouping and classification.
+ * Used to categorize errors in the execution_errors table metadata.
+ */
+type ExecutionErrorCategory = 'llm' | 'tool' | 'workflow' | 'agent' | 'validation' | 'system';
+
+/**
+ * Shared form field types for dynamic form generation
+ * Used by: Command Queue, Execution Runner UI, future form-based features
+ */
+/**
+ * Supported form field types for action payloads
+ * Maps to Mantine form components
+ */
+type FormFieldType = 'text' | 'textarea' | 'number' | 'select' | 'checkbox' | 'radio' | 'richtext';
+/**
+ * Form field definition
+ */
+interface FormField {
+    /** Field key in payload object */
+    name: string;
+    /** Field label for UI */
+    label: string;
+    /** Field type (determines UI component) */
+    type: FormFieldType;
+    /** Default value */
+    defaultValue?: unknown;
+    /** Required field */
+    required?: boolean;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Help text */
+    description?: string;
+    /** Options for select/radio */
+    options?: Array<{
+        label: string;
+        value: string | number;
+    }>;
+    /** Min/max for number */
+    min?: number;
+    max?: number;
+    /** Path to context value for pre-filling (dot notation, e.g., 'proposal.summary') */
+    defaultValueFromContext?: string;
+}
+/**
+ * Form schema for action payload collection
+ */
+interface FormSchema {
+    /** Form title */
+    title?: string;
+    /** Form description */
+    description?: string;
+    /** Form fields */
+    fields: FormField[];
+}
+
+/**
+ * Serialized Registry Types
+ *
+ * Pre-computed JSON-safe types for API responses and Command View.
+ * Serialization happens once at API startup, enabling instant response times.
+ */
+
+/**
+ * Serialized form field for API responses
+ */
+interface SerializedFormField {
+    name: string;
+    label: string;
+    type: FormFieldType;
+    defaultValue?: unknown;
+    required?: boolean;
+    placeholder?: string;
+    description?: string;
+    options?: Array<{
+        label: string;
+        value: string | number;
+    }>;
+    min?: number;
+    max?: number;
+}
+/**
+ * Serialized form schema for API responses
+ */
+interface SerializedFormSchema {
+    title?: string;
+    description?: string;
+    fields: SerializedFormField[];
+    layout?: 'vertical' | 'horizontal' | 'grid';
+}
+/**
+ * Serialized execution form schema for API responses
+ */
+interface SerializedExecutionFormSchema extends SerializedFormSchema {
+    fieldMappings?: Record<string, string>;
+    submitButton?: {
+        label?: string;
+        loadingLabel?: string;
+        confirmMessage?: string;
+    };
+}
+/**
+ * Serialized schedule config for API responses
+ */
+interface SerializedScheduleConfig {
+    enabled: boolean;
+    defaultSchedule?: string;
+    allowedPatterns?: string[];
+}
+/**
+ * Serialized webhook config for API responses
+ */
+interface SerializedWebhookConfig {
+    enabled: boolean;
+    payloadSchema?: unknown;
+}
+/**
+ * Serialized execution interface for API responses
+ */
+interface SerializedExecutionInterface {
+    form: SerializedExecutionFormSchema;
+    schedule?: SerializedScheduleConfig;
+    webhook?: SerializedWebhookConfig;
+}
+/**
+ * Serialized agent definition (JSON-safe)
+ * Result of serializeDefinition(AgentDefinition)
+ */
+interface SerializedAgentDefinition {
+    config: {
+        resourceId: string;
+        name: string;
+        description: string;
+        version: string;
+        type: 'agent';
+        status: 'dev' | 'prod';
+        /** Whether this resource is archived and should be excluded from registration and deployment */
+        archived?: boolean;
+        systemPrompt: string;
+        constraints?: {
+            maxIterations?: number;
+            timeout?: number;
+            maxSessionMemoryKeys?: number;
+            maxMemoryTokens?: number;
+        };
+        sessionCapable?: boolean;
+        memoryPreferences?: string;
+    };
+    modelConfig: {
+        provider: string;
+        model: string;
+        apiKey: string;
+        temperature: number;
+        maxOutputTokens: number;
+        topP?: number;
+        modelOptions?: Record<string, unknown>;
+    };
+    contract: {
+        inputSchema: object;
+        outputSchema?: object;
+    };
+    tools: Array<{
+        name: string;
+        description: string;
+        inputSchema?: object;
+        outputSchema?: object;
+    }>;
+    knowledgeMap?: {
+        nodeCount: number;
+        nodes: Array<{
+            id: string;
+            description: string;
+            loaded: boolean;
+            hasPrompt: boolean;
+        }>;
+    };
+    metricsConfig?: object;
+    interface?: SerializedExecutionInterface;
+}
+/**
+ * Serialized workflow definition (JSON-safe)
+ * Result of serializeDefinition(WorkflowDefinition)
+ */
+interface SerializedWorkflowDefinition {
+    config: {
+        resourceId: string;
+        name: string;
+        description: string;
+        version: string;
+        type: 'workflow';
+        status: 'dev' | 'prod';
+        /** Whether this resource is archived and should be excluded from registration and deployment */
+        archived?: boolean;
+    };
+    entryPoint: string;
+    steps: Array<{
+        id: string;
+        name: string;
+        description: string;
+        inputSchema?: object;
+        outputSchema?: object;
+        next: {
+            type: 'linear' | 'conditional';
+            target?: string;
+            routes?: Array<{
+                target: string;
+            }>;
+            default?: string;
+        } | null;
+    }>;
+    contract: {
+        inputSchema: object;
+        outputSchema?: object;
+    };
+    metricsConfig?: object;
+    interface?: SerializedExecutionInterface;
+}
+
+/**
+ * Memory type definitions
+ * Types for agent memory management with semantic entry types
+ */
+/**
+ * Semantic memory entry types
+ * Use-case agnostic types that describe the purpose of each entry
+ * Memory types mirror action types for clarity and filtering
+ */
+type MemoryEntryType = 'context' | 'input' | 'reasoning' | 'tool-result' | 'delegation-result' | 'error';
+/**
+ * Memory entry - represents a single entry in agent memory
+ * Stored in agent memory, translated by adapters to vendor-specific formats
+ */
+interface MemoryEntry {
+    type: MemoryEntryType;
+    content: string;
+    timestamp: number;
+    turnNumber: number | null;
+    iterationNumber: number | null;
+}
+/**
+ * Agent memory - Self-orchestrated memory with session + working storage
+ * Agent has full control over what persists, framework handles auto-compaction
+ */
+interface AgentMemory {
+    /**
+     * Session memory - Persists for session/conversation duration
+     * Never auto-trimmed by framework
+     * Agent-managed key-value store for critical information
+     * Agent provides strings, framework wraps in MemoryEntry
+     */
+    sessionMemory: Record<string, MemoryEntry>;
+    /**
+     * Working memory - Execution history
+     * Automatically compacted by framework when needed
+     * Agent doesn't control compaction
+     */
+    history: MemoryEntry[];
+}
+
+type Json = string | number | boolean | null | {
+    [key: string]: Json | undefined;
+} | Json[];
+type Database = {
+    __InternalSupabase: {
+        PostgrestVersion: "12.2.3 (519615d)";
+    };
+    public: {
+        Tables: {
+            acq_companies: {
+                Row: {
+                    attio_company_id: string | null;
+                    batch_id: string | null;
+                    category: string | null;
+                    category_pain: string | null;
+                    created_at: string;
+                    domain: string | null;
+                    enrichment_data: Json | null;
+                    filter_reason: string | null;
+                    founded_year: number | null;
+                    id: string;
+                    linkedin_url: string | null;
+                    location_city: string | null;
+                    location_state: string | null;
+                    name: string;
+                    num_employees: number | null;
+                    organization_id: string;
+                    pipeline_status: Json;
+                    segment: string | null;
+                    source: string | null;
+                    status: string;
+                    updated_at: string;
+                    website: string | null;
+                };
+                Insert: {
+                    attio_company_id?: string | null;
+                    batch_id?: string | null;
+                    category?: string | null;
+                    category_pain?: string | null;
+                    created_at?: string;
+                    domain?: string | null;
+                    enrichment_data?: Json | null;
+                    filter_reason?: string | null;
+                    founded_year?: number | null;
+                    id?: string;
+                    linkedin_url?: string | null;
+                    location_city?: string | null;
+                    location_state?: string | null;
+                    name: string;
+                    num_employees?: number | null;
+                    organization_id: string;
+                    pipeline_status?: Json;
+                    segment?: string | null;
+                    source?: string | null;
+                    status?: string;
+                    updated_at?: string;
+                    website?: string | null;
+                };
+                Update: {
+                    attio_company_id?: string | null;
+                    batch_id?: string | null;
+                    category?: string | null;
+                    category_pain?: string | null;
+                    created_at?: string;
+                    domain?: string | null;
+                    enrichment_data?: Json | null;
+                    filter_reason?: string | null;
+                    founded_year?: number | null;
+                    id?: string;
+                    linkedin_url?: string | null;
+                    location_city?: string | null;
+                    location_state?: string | null;
+                    name?: string;
+                    num_employees?: number | null;
+                    organization_id?: string;
+                    pipeline_status?: Json;
+                    segment?: string | null;
+                    source?: string | null;
+                    status?: string;
+                    updated_at?: string;
+                    website?: string | null;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "acq_companies_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            acq_contacts: {
+                Row: {
+                    attio_person_id: string | null;
+                    batch_id: string | null;
+                    brochure_first_viewed_at: string | null;
+                    brochure_view_count: number;
+                    company_id: string | null;
+                    created_at: string;
+                    email: string;
+                    email_valid: string | null;
+                    enrichment_data: Json;
+                    filter_reason: string | null;
+                    first_name: string | null;
+                    headline: string | null;
+                    id: string;
+                    last_name: string | null;
+                    linkedin_url: string | null;
+                    nurture: boolean;
+                    opening_line: string | null;
+                    organization_id: string;
+                    pipeline_status: Json;
+                    source: string | null;
+                    source_id: string | null;
+                    status: string;
+                    title: string | null;
+                    updated_at: string;
+                };
+                Insert: {
+                    attio_person_id?: string | null;
+                    batch_id?: string | null;
+                    brochure_first_viewed_at?: string | null;
+                    brochure_view_count?: number;
+                    company_id?: string | null;
+                    created_at?: string;
+                    email: string;
+                    email_valid?: string | null;
+                    enrichment_data?: Json;
+                    filter_reason?: string | null;
+                    first_name?: string | null;
+                    headline?: string | null;
+                    id?: string;
+                    last_name?: string | null;
+                    linkedin_url?: string | null;
+                    nurture?: boolean;
+                    opening_line?: string | null;
+                    organization_id: string;
+                    pipeline_status?: Json;
+                    source?: string | null;
+                    source_id?: string | null;
+                    status?: string;
+                    title?: string | null;
+                    updated_at?: string;
+                };
+                Update: {
+                    attio_person_id?: string | null;
+                    batch_id?: string | null;
+                    brochure_first_viewed_at?: string | null;
+                    brochure_view_count?: number;
+                    company_id?: string | null;
+                    created_at?: string;
+                    email?: string;
+                    email_valid?: string | null;
+                    enrichment_data?: Json;
+                    filter_reason?: string | null;
+                    first_name?: string | null;
+                    headline?: string | null;
+                    id?: string;
+                    last_name?: string | null;
+                    linkedin_url?: string | null;
+                    nurture?: boolean;
+                    opening_line?: string | null;
+                    organization_id?: string;
+                    pipeline_status?: Json;
+                    source?: string | null;
+                    source_id?: string | null;
+                    status?: string;
+                    title?: string | null;
+                    updated_at?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "acq_contacts_company_id_fkey";
+                        columns: ["company_id"];
+                        isOneToOne: false;
+                        referencedRelation: "acq_companies";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "acq_contacts_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            acq_content: {
+                Row: {
+                    body: string | null;
+                    created_at: string;
+                    id: string;
+                    organization_id: string;
+                    pillar: string;
+                    status: string;
+                    title: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    body?: string | null;
+                    created_at?: string;
+                    id?: string;
+                    organization_id: string;
+                    pillar: string;
+                    status?: string;
+                    title: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    body?: string | null;
+                    created_at?: string;
+                    id?: string;
+                    organization_id?: string;
+                    pillar?: string;
+                    status?: string;
+                    title?: string;
+                    updated_at?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "acq_content_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            acq_content_distributions: {
+                Row: {
+                    adapted_body: string | null;
+                    checklist: Json | null;
+                    content_id: string;
+                    created_at: string;
+                    format: string;
+                    id: string;
+                    media_urls: Json;
+                    metrics: Json;
+                    metrics_updated_at: string | null;
+                    organization_id: string;
+                    platform: string;
+                    platform_content: Json | null;
+                    platform_post_id: string | null;
+                    platform_url: string | null;
+                    published_at: string | null;
+                    status: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    adapted_body?: string | null;
+                    checklist?: Json | null;
+                    content_id: string;
+                    created_at?: string;
+                    format: string;
+                    id?: string;
+                    media_urls?: Json;
+                    metrics?: Json;
+                    metrics_updated_at?: string | null;
+                    organization_id: string;
+                    platform: string;
+                    platform_content?: Json | null;
+                    platform_post_id?: string | null;
+                    platform_url?: string | null;
+                    published_at?: string | null;
+                    status?: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    adapted_body?: string | null;
+                    checklist?: Json | null;
+                    content_id?: string;
+                    created_at?: string;
+                    format?: string;
+                    id?: string;
+                    media_urls?: Json;
+                    metrics?: Json;
+                    metrics_updated_at?: string | null;
+                    organization_id?: string;
+                    platform?: string;
+                    platform_content?: Json | null;
+                    platform_post_id?: string | null;
+                    platform_url?: string | null;
+                    published_at?: string | null;
+                    status?: string;
+                    updated_at?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "acq_content_distributions_content_id_fkey";
+                        columns: ["content_id"];
+                        isOneToOne: false;
+                        referencedRelation: "acq_content";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "acq_content_distributions_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            acq_deals: {
+                Row: {
+                    activity_log: Json;
+                    attio_deal_id: string;
+                    cached_stage: string | null;
+                    closed_lost_at: string | null;
+                    closed_lost_reason: string | null;
+                    contact_email: string;
+                    contact_id: string | null;
+                    created_at: string;
+                    discovery_data: Json | null;
+                    discovery_submitted_at: string | null;
+                    discovery_submitted_by: string | null;
+                    id: string;
+                    initial_fee: number | null;
+                    monthly_fee: number | null;
+                    organization_id: string;
+                    payment_link_sent_at: string | null;
+                    payment_received_at: string | null;
+                    proposal_data: Json | null;
+                    proposal_generated_at: string | null;
+                    proposal_pdf_url: string | null;
+                    proposal_reviewed_at: string | null;
+                    proposal_reviewed_by: string | null;
+                    proposal_sent_at: string | null;
+                    proposal_signed_at: string | null;
+                    proposal_status: string | null;
+                    signature_envelope_id: string | null;
+                    source_list_id: string | null;
+                    source_type: string | null;
+                    stripe_payment_id: string | null;
+                    stripe_payment_link: string | null;
+                    stripe_payment_link_id: string | null;
+                    stripe_subscription_id: string | null;
+                    updated_at: string;
+                };
+                Insert: {
+                    activity_log?: Json;
+                    attio_deal_id: string;
+                    cached_stage?: string | null;
+                    closed_lost_at?: string | null;
+                    closed_lost_reason?: string | null;
+                    contact_email: string;
+                    contact_id?: string | null;
+                    created_at?: string;
+                    discovery_data?: Json | null;
+                    discovery_submitted_at?: string | null;
+                    discovery_submitted_by?: string | null;
+                    id?: string;
+                    initial_fee?: number | null;
+                    monthly_fee?: number | null;
+                    organization_id: string;
+                    payment_link_sent_at?: string | null;
+                    payment_received_at?: string | null;
+                    proposal_data?: Json | null;
+                    proposal_generated_at?: string | null;
+                    proposal_pdf_url?: string | null;
+                    proposal_reviewed_at?: string | null;
+                    proposal_reviewed_by?: string | null;
+                    proposal_sent_at?: string | null;
+                    proposal_signed_at?: string | null;
+                    proposal_status?: string | null;
+                    signature_envelope_id?: string | null;
+                    source_list_id?: string | null;
+                    source_type?: string | null;
+                    stripe_payment_id?: string | null;
+                    stripe_payment_link?: string | null;
+                    stripe_payment_link_id?: string | null;
+                    stripe_subscription_id?: string | null;
+                    updated_at?: string;
+                };
+                Update: {
+                    activity_log?: Json;
+                    attio_deal_id?: string;
+                    cached_stage?: string | null;
+                    closed_lost_at?: string | null;
+                    closed_lost_reason?: string | null;
+                    contact_email?: string;
+                    contact_id?: string | null;
+                    created_at?: string;
+                    discovery_data?: Json | null;
+                    discovery_submitted_at?: string | null;
+                    discovery_submitted_by?: string | null;
+                    id?: string;
+                    initial_fee?: number | null;
+                    monthly_fee?: number | null;
+                    organization_id?: string;
+                    payment_link_sent_at?: string | null;
+                    payment_received_at?: string | null;
+                    proposal_data?: Json | null;
+                    proposal_generated_at?: string | null;
+                    proposal_pdf_url?: string | null;
+                    proposal_reviewed_at?: string | null;
+                    proposal_reviewed_by?: string | null;
+                    proposal_sent_at?: string | null;
+                    proposal_signed_at?: string | null;
+                    proposal_status?: string | null;
+                    signature_envelope_id?: string | null;
+                    source_list_id?: string | null;
+                    source_type?: string | null;
+                    stripe_payment_id?: string | null;
+                    stripe_payment_link?: string | null;
+                    stripe_payment_link_id?: string | null;
+                    stripe_subscription_id?: string | null;
+                    updated_at?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "acq_deals_contact_id_fkey";
+                        columns: ["contact_id"];
+                        isOneToOne: false;
+                        referencedRelation: "acq_contacts";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "acq_deals_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "acq_deals_source_list_id_fkey";
+                        columns: ["source_list_id"];
+                        isOneToOne: false;
+                        referencedRelation: "acq_lists";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            acq_list_members: {
+                Row: {
+                    added_at: string;
+                    added_by: string | null;
+                    contact_id: string;
+                    id: string;
+                    list_id: string;
+                };
+                Insert: {
+                    added_at?: string;
+                    added_by?: string | null;
+                    contact_id: string;
+                    id?: string;
+                    list_id: string;
+                };
+                Update: {
+                    added_at?: string;
+                    added_by?: string | null;
+                    contact_id?: string;
+                    id?: string;
+                    list_id?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "acq_list_members_contact_id_fkey";
+                        columns: ["contact_id"];
+                        isOneToOne: false;
+                        referencedRelation: "acq_contacts";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "acq_list_members_list_id_fkey";
+                        columns: ["list_id"];
+                        isOneToOne: false;
+                        referencedRelation: "acq_lists";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            acq_lists: {
+                Row: {
+                    batch_ids: string[];
+                    completed_at: string | null;
+                    created_at: string;
+                    description: string | null;
+                    id: string;
+                    instantly_campaign_id: string | null;
+                    launched_at: string | null;
+                    metadata: Json;
+                    name: string;
+                    organization_id: string;
+                    status: string;
+                    type: string;
+                };
+                Insert: {
+                    batch_ids?: string[];
+                    completed_at?: string | null;
+                    created_at?: string;
+                    description?: string | null;
+                    id?: string;
+                    instantly_campaign_id?: string | null;
+                    launched_at?: string | null;
+                    metadata?: Json;
+                    name: string;
+                    organization_id: string;
+                    status?: string;
+                    type?: string;
+                };
+                Update: {
+                    batch_ids?: string[];
+                    completed_at?: string | null;
+                    created_at?: string;
+                    description?: string | null;
+                    id?: string;
+                    instantly_campaign_id?: string | null;
+                    launched_at?: string | null;
+                    metadata?: Json;
+                    name?: string;
+                    organization_id?: string;
+                    status?: string;
+                    type?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "acq_lists_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            acq_seo_metrics: {
+                Row: {
+                    ai_citations: Json | null;
+                    avg_position: number | null;
+                    clicks: number | null;
+                    created_at: string;
+                    cta_clicks: number | null;
+                    ctr: number | null;
+                    data_point_count: number | null;
+                    faq_count: number | null;
+                    form_submissions: number | null;
+                    id: string;
+                    impressions: number | null;
+                    organization_id: string;
+                    period: string;
+                    quality_score: number | null;
+                    readability: number | null;
+                    scroll_100: number | null;
+                    scroll_25: number | null;
+                    scroll_50: number | null;
+                    scroll_75: number | null;
+                    seo_page_id: string;
+                    word_count: number | null;
+                };
+                Insert: {
+                    ai_citations?: Json | null;
+                    avg_position?: number | null;
+                    clicks?: number | null;
+                    created_at?: string;
+                    cta_clicks?: number | null;
+                    ctr?: number | null;
+                    data_point_count?: number | null;
+                    faq_count?: number | null;
+                    form_submissions?: number | null;
+                    id?: string;
+                    impressions?: number | null;
+                    organization_id: string;
+                    period: string;
+                    quality_score?: number | null;
+                    readability?: number | null;
+                    scroll_100?: number | null;
+                    scroll_25?: number | null;
+                    scroll_50?: number | null;
+                    scroll_75?: number | null;
+                    seo_page_id: string;
+                    word_count?: number | null;
+                };
+                Update: {
+                    ai_citations?: Json | null;
+                    avg_position?: number | null;
+                    clicks?: number | null;
+                    created_at?: string;
+                    cta_clicks?: number | null;
+                    ctr?: number | null;
+                    data_point_count?: number | null;
+                    faq_count?: number | null;
+                    form_submissions?: number | null;
+                    id?: string;
+                    impressions?: number | null;
+                    organization_id?: string;
+                    period?: string;
+                    quality_score?: number | null;
+                    readability?: number | null;
+                    scroll_100?: number | null;
+                    scroll_25?: number | null;
+                    scroll_50?: number | null;
+                    scroll_75?: number | null;
+                    seo_page_id?: string;
+                    word_count?: number | null;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "acq_seo_metrics_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "acq_seo_metrics_seo_page_id_fkey";
+                        columns: ["seo_page_id"];
+                        isOneToOne: false;
+                        referencedRelation: "acq_seo_pages";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            acq_seo_pages: {
+                Row: {
+                    city: string | null;
+                    content: Json | null;
+                    created_at: string;
+                    faq_items: Json | null;
+                    hero_image_url: string | null;
+                    id: string;
+                    internal_links: Json | null;
+                    local_data: Json | null;
+                    meta_description: string | null;
+                    organization_id: string;
+                    page_type: string;
+                    published_at: string | null;
+                    refreshed_at: string | null;
+                    schema_markup: Json | null;
+                    slug: string;
+                    state: string | null;
+                    status: string;
+                    title: string;
+                    updated_at: string;
+                    use_case: string | null;
+                    vertical: string;
+                };
+                Insert: {
+                    city?: string | null;
+                    content?: Json | null;
+                    created_at?: string;
+                    faq_items?: Json | null;
+                    hero_image_url?: string | null;
+                    id?: string;
+                    internal_links?: Json | null;
+                    local_data?: Json | null;
+                    meta_description?: string | null;
+                    organization_id: string;
+                    page_type: string;
+                    published_at?: string | null;
+                    refreshed_at?: string | null;
+                    schema_markup?: Json | null;
+                    slug: string;
+                    state?: string | null;
+                    status?: string;
+                    title: string;
+                    updated_at?: string;
+                    use_case?: string | null;
+                    vertical: string;
+                };
+                Update: {
+                    city?: string | null;
+                    content?: Json | null;
+                    created_at?: string;
+                    faq_items?: Json | null;
+                    hero_image_url?: string | null;
+                    id?: string;
+                    internal_links?: Json | null;
+                    local_data?: Json | null;
+                    meta_description?: string | null;
+                    organization_id?: string;
+                    page_type?: string;
+                    published_at?: string | null;
+                    refreshed_at?: string | null;
+                    schema_markup?: Json | null;
+                    slug?: string;
+                    state?: string | null;
+                    status?: string;
+                    title?: string;
+                    updated_at?: string;
+                    use_case?: string | null;
+                    vertical?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "acq_seo_pages_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            acq_social_posts: {
+                Row: {
+                    author_name: string;
+                    author_url: string | null;
+                    comments_count: number;
+                    created_at: string;
+                    discovered_at: string;
+                    engagement_count: number;
+                    feedback: string | null;
+                    final_response: string | null;
+                    fully_reviewed: boolean;
+                    id: string;
+                    initial_draft: string | null;
+                    matched_keywords: string[];
+                    matched_query: string | null;
+                    metadata: Json;
+                    organization_id: string;
+                    platform: string;
+                    platform_post_id: string;
+                    post_text: string;
+                    post_title: string;
+                    post_url: string;
+                    posted_at: string;
+                    relevance_score: number;
+                    responded_at: string | null;
+                    reviewed_at: string | null;
+                    skip_reason: string | null;
+                    source_category: string | null;
+                    status: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    author_name: string;
+                    author_url?: string | null;
+                    comments_count?: number;
+                    created_at?: string;
+                    discovered_at?: string;
+                    engagement_count?: number;
+                    feedback?: string | null;
+                    final_response?: string | null;
+                    fully_reviewed?: boolean;
+                    id?: string;
+                    initial_draft?: string | null;
+                    matched_keywords?: string[];
+                    matched_query?: string | null;
+                    metadata?: Json;
+                    organization_id: string;
+                    platform: string;
+                    platform_post_id: string;
+                    post_text: string;
+                    post_title: string;
+                    post_url: string;
+                    posted_at: string;
+                    relevance_score?: number;
+                    responded_at?: string | null;
+                    reviewed_at?: string | null;
+                    skip_reason?: string | null;
+                    source_category?: string | null;
+                    status?: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    author_name?: string;
+                    author_url?: string | null;
+                    comments_count?: number;
+                    created_at?: string;
+                    discovered_at?: string;
+                    engagement_count?: number;
+                    feedback?: string | null;
+                    final_response?: string | null;
+                    fully_reviewed?: boolean;
+                    id?: string;
+                    initial_draft?: string | null;
+                    matched_keywords?: string[];
+                    matched_query?: string | null;
+                    metadata?: Json;
+                    organization_id?: string;
+                    platform?: string;
+                    platform_post_id?: string;
+                    post_text?: string;
+                    post_title?: string;
+                    post_url?: string;
+                    posted_at?: string;
+                    relevance_score?: number;
+                    responded_at?: string | null;
+                    reviewed_at?: string | null;
+                    skip_reason?: string | null;
+                    source_category?: string | null;
+                    status?: string;
+                    updated_at?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "acq_social_posts_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            activities: {
+                Row: {
+                    activity_type: string;
+                    actor_id: string | null;
+                    actor_type: string | null;
+                    created_at: string;
+                    description: string | null;
+                    entity_id: string;
+                    entity_name: string | null;
+                    entity_type: string;
+                    id: string;
+                    metadata: Json | null;
+                    occurred_at: string;
+                    organization_id: string;
+                    status: string;
+                    title: string;
+                };
+                Insert: {
+                    activity_type: string;
+                    actor_id?: string | null;
+                    actor_type?: string | null;
+                    created_at?: string;
+                    description?: string | null;
+                    entity_id: string;
+                    entity_name?: string | null;
+                    entity_type: string;
+                    id?: string;
+                    metadata?: Json | null;
+                    occurred_at?: string;
+                    organization_id: string;
+                    status: string;
+                    title: string;
+                };
+                Update: {
+                    activity_type?: string;
+                    actor_id?: string | null;
+                    actor_type?: string | null;
+                    created_at?: string;
+                    description?: string | null;
+                    entity_id?: string;
+                    entity_name?: string | null;
+                    entity_type?: string;
+                    id?: string;
+                    metadata?: Json | null;
+                    occurred_at?: string;
+                    organization_id?: string;
+                    status?: string;
+                    title?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "activities_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            api_keys: {
+                Row: {
+                    created_at: string | null;
+                    id: string;
+                    key_hash: string;
+                    last_used_at: string | null;
+                    name: string;
+                    organization_id: string;
+                };
+                Insert: {
+                    created_at?: string | null;
+                    id?: string;
+                    key_hash: string;
+                    last_used_at?: string | null;
+                    name: string;
+                    organization_id: string;
+                };
+                Update: {
+                    created_at?: string | null;
+                    id?: string;
+                    key_hash?: string;
+                    last_used_at?: string | null;
+                    name?: string;
+                    organization_id?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "api_keys_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            calibration_projects: {
+                Row: {
+                    created_at: string | null;
+                    description: string | null;
+                    id: string;
+                    name: string;
+                    organization_id: string;
+                    resource_id: string;
+                    resource_type: string;
+                    updated_at: string | null;
+                };
+                Insert: {
+                    created_at?: string | null;
+                    description?: string | null;
+                    id?: string;
+                    name: string;
+                    organization_id: string;
+                    resource_id: string;
+                    resource_type: string;
+                    updated_at?: string | null;
+                };
+                Update: {
+                    created_at?: string | null;
+                    description?: string | null;
+                    id?: string;
+                    name?: string;
+                    organization_id?: string;
+                    resource_id?: string;
+                    resource_type?: string;
+                    updated_at?: string | null;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "calibration_projects_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            calibration_runs: {
+                Row: {
+                    completed_at: string | null;
+                    config_variants: Json;
+                    created_at: string | null;
+                    description: string | null;
+                    execution_mode: string;
+                    grader_model: string | null;
+                    grading_rubric: Json | null;
+                    id: string;
+                    name: string;
+                    organization_id: string;
+                    project_id: string;
+                    results: Json;
+                    status: string;
+                    test_inputs: Json;
+                };
+                Insert: {
+                    completed_at?: string | null;
+                    config_variants: Json;
+                    created_at?: string | null;
+                    description?: string | null;
+                    execution_mode?: string;
+                    grader_model?: string | null;
+                    grading_rubric?: Json | null;
+                    id?: string;
+                    name: string;
+                    organization_id: string;
+                    project_id: string;
+                    results?: Json;
+                    status?: string;
+                    test_inputs: Json;
+                };
+                Update: {
+                    completed_at?: string | null;
+                    config_variants?: Json;
+                    created_at?: string | null;
+                    description?: string | null;
+                    execution_mode?: string;
+                    grader_model?: string | null;
+                    grading_rubric?: Json | null;
+                    id?: string;
+                    name?: string;
+                    organization_id?: string;
+                    project_id?: string;
+                    results?: Json;
+                    status?: string;
+                    test_inputs?: Json;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "calibration_runs_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "calibration_runs_project_id_fkey";
+                        columns: ["project_id"];
+                        isOneToOne: false;
+                        referencedRelation: "calibration_projects";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            command_queue: {
+                Row: {
+                    action_payload: Json | null;
+                    actions: Json;
+                    completed_at: string | null;
+                    completed_by: string | null;
+                    context: Json;
+                    created_at: string;
+                    description: string | null;
+                    expires_at: string | null;
+                    human_checkpoint: string | null;
+                    id: string;
+                    idempotency_key: string | null;
+                    metadata: Json | null;
+                    organization_id: string;
+                    origin_execution_id: string;
+                    origin_resource_id: string;
+                    origin_resource_type: string;
+                    priority: number;
+                    selected_action: string | null;
+                    status: string;
+                    target_execution_id: string | null;
+                    target_resource_id: string | null;
+                    target_resource_type: string | null;
+                };
+                Insert: {
+                    action_payload?: Json | null;
+                    actions: Json;
+                    completed_at?: string | null;
+                    completed_by?: string | null;
+                    context: Json;
+                    created_at?: string;
+                    description?: string | null;
+                    expires_at?: string | null;
+                    human_checkpoint?: string | null;
+                    id?: string;
+                    idempotency_key?: string | null;
+                    metadata?: Json | null;
+                    organization_id: string;
+                    origin_execution_id: string;
+                    origin_resource_id: string;
+                    origin_resource_type: string;
+                    priority?: number;
+                    selected_action?: string | null;
+                    status?: string;
+                    target_execution_id?: string | null;
+                    target_resource_id?: string | null;
+                    target_resource_type?: string | null;
+                };
+                Update: {
+                    action_payload?: Json | null;
+                    actions?: Json;
+                    completed_at?: string | null;
+                    completed_by?: string | null;
+                    context?: Json;
+                    created_at?: string;
+                    description?: string | null;
+                    expires_at?: string | null;
+                    human_checkpoint?: string | null;
+                    id?: string;
+                    idempotency_key?: string | null;
+                    metadata?: Json | null;
+                    organization_id?: string;
+                    origin_execution_id?: string;
+                    origin_resource_id?: string;
+                    origin_resource_type?: string;
+                    priority?: number;
+                    selected_action?: string | null;
+                    status?: string;
+                    target_execution_id?: string | null;
+                    target_resource_id?: string | null;
+                    target_resource_type?: string | null;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "command_queue_completed_by_fkey";
+                        columns: ["completed_by"];
+                        isOneToOne: false;
+                        referencedRelation: "users";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "command_queue_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "command_queue_target_execution_id_fkey";
+                        columns: ["target_execution_id"];
+                        isOneToOne: false;
+                        referencedRelation: "execution_logs";
+                        referencedColumns: ["execution_id"];
+                    }
+                ];
+            };
+            credentials: {
+                Row: {
+                    created_at: string;
+                    created_by: string | null;
+                    encrypted_value: string;
+                    id: string;
+                    name: string;
+                    organization_id: string;
+                    provider: string | null;
+                    type: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    created_at?: string;
+                    created_by?: string | null;
+                    encrypted_value: string;
+                    id?: string;
+                    name: string;
+                    organization_id: string;
+                    provider?: string | null;
+                    type?: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    created_at?: string;
+                    created_by?: string | null;
+                    encrypted_value?: string;
+                    id?: string;
+                    name?: string;
+                    organization_id?: string;
+                    provider?: string | null;
+                    type?: string;
+                    updated_at?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "credentials_created_by_fkey";
+                        columns: ["created_by"];
+                        isOneToOne: false;
+                        referencedRelation: "users";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "credentials_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            deployments: {
+                Row: {
+                    compiled_docs: Json | null;
+                    created_at: string;
+                    deployment_version: string | null;
+                    documentation: Json | null;
+                    error_message: string | null;
+                    id: string;
+                    organization_id: string;
+                    pid: number | null;
+                    port: number | null;
+                    sdk_version: string;
+                    status: string;
+                    tarball_path: string | null;
+                    updated_at: string;
+                };
+                Insert: {
+                    compiled_docs?: Json | null;
+                    created_at?: string;
+                    deployment_version?: string | null;
+                    documentation?: Json | null;
+                    error_message?: string | null;
+                    id?: string;
+                    organization_id: string;
+                    pid?: number | null;
+                    port?: number | null;
+                    sdk_version: string;
+                    status?: string;
+                    tarball_path?: string | null;
+                    updated_at?: string;
+                };
+                Update: {
+                    compiled_docs?: Json | null;
+                    created_at?: string;
+                    deployment_version?: string | null;
+                    documentation?: Json | null;
+                    error_message?: string | null;
+                    id?: string;
+                    organization_id?: string;
+                    pid?: number | null;
+                    port?: number | null;
+                    sdk_version?: string;
+                    status?: string;
+                    tarball_path?: string | null;
+                    updated_at?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "deployments_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            execution_errors: {
+                Row: {
+                    created_at: string | null;
+                    error_category: string;
+                    error_message: string;
+                    error_severity: string;
+                    error_stack_trace: string | null;
+                    error_type: string;
+                    execution_id: string;
+                    id: string;
+                    metadata: Json | null;
+                    occurred_at: string;
+                    organization_id: string;
+                    resolved: boolean;
+                    resolved_at: string | null;
+                    resolved_by: string | null;
+                };
+                Insert: {
+                    created_at?: string | null;
+                    error_category: string;
+                    error_message: string;
+                    error_severity: string;
+                    error_stack_trace?: string | null;
+                    error_type: string;
+                    execution_id: string;
+                    id?: string;
+                    metadata?: Json | null;
+                    occurred_at?: string;
+                    organization_id: string;
+                    resolved?: boolean;
+                    resolved_at?: string | null;
+                    resolved_by?: string | null;
+                };
+                Update: {
+                    created_at?: string | null;
+                    error_category?: string;
+                    error_message?: string;
+                    error_severity?: string;
+                    error_stack_trace?: string | null;
+                    error_type?: string;
+                    execution_id?: string;
+                    id?: string;
+                    metadata?: Json | null;
+                    occurred_at?: string;
+                    organization_id?: string;
+                    resolved?: boolean;
+                    resolved_at?: string | null;
+                    resolved_by?: string | null;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "execution_errors_execution_id_fkey";
+                        columns: ["execution_id"];
+                        isOneToOne: false;
+                        referencedRelation: "execution_logs";
+                        referencedColumns: ["execution_id"];
+                    },
+                    {
+                        foreignKeyName: "execution_errors_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "execution_errors_resolved_by_fkey";
+                        columns: ["resolved_by"];
+                        isOneToOne: false;
+                        referencedRelation: "users";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            execution_logs: {
+                Row: {
+                    api_version: string | null;
+                    completed_at: string | null;
+                    created_at: string | null;
+                    error: string | null;
+                    execution_id: string;
+                    input: Json | null;
+                    last_heartbeat_at: string | null;
+                    logs: Json | null;
+                    organization_id: string;
+                    origin_execution_id: string | null;
+                    output: Json | null;
+                    resource_id: string;
+                    resource_status: string;
+                    resource_type: string;
+                    resource_version: string | null;
+                    sdk_version: string | null;
+                    session_id: string | null;
+                    session_turn_number: number | null;
+                    started_at: string;
+                    status: string;
+                    trigger_type: string | null;
+                    updated_at: string | null;
+                    user_id: string | null;
+                };
+                Insert: {
+                    api_version?: string | null;
+                    completed_at?: string | null;
+                    created_at?: string | null;
+                    error?: string | null;
+                    execution_id?: string;
+                    input?: Json | null;
+                    last_heartbeat_at?: string | null;
+                    logs?: Json | null;
+                    organization_id: string;
+                    origin_execution_id?: string | null;
+                    output?: Json | null;
+                    resource_id: string;
+                    resource_status?: string;
+                    resource_type?: string;
+                    resource_version?: string | null;
+                    sdk_version?: string | null;
+                    session_id?: string | null;
+                    session_turn_number?: number | null;
+                    started_at?: string;
+                    status: string;
+                    trigger_type?: string | null;
+                    updated_at?: string | null;
+                    user_id?: string | null;
+                };
+                Update: {
+                    api_version?: string | null;
+                    completed_at?: string | null;
+                    created_at?: string | null;
+                    error?: string | null;
+                    execution_id?: string;
+                    input?: Json | null;
+                    last_heartbeat_at?: string | null;
+                    logs?: Json | null;
+                    organization_id?: string;
+                    origin_execution_id?: string | null;
+                    output?: Json | null;
+                    resource_id?: string;
+                    resource_status?: string;
+                    resource_type?: string;
+                    resource_version?: string | null;
+                    sdk_version?: string | null;
+                    session_id?: string | null;
+                    session_turn_number?: number | null;
+                    started_at?: string;
+                    status?: string;
+                    trigger_type?: string | null;
+                    updated_at?: string | null;
+                    user_id?: string | null;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "execution_history_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "execution_logs_origin_execution_id_fkey";
+                        columns: ["origin_execution_id"];
+                        isOneToOne: false;
+                        referencedRelation: "execution_logs";
+                        referencedColumns: ["execution_id"];
+                    },
+                    {
+                        foreignKeyName: "execution_logs_session_id_fkey";
+                        columns: ["session_id"];
+                        isOneToOne: false;
+                        referencedRelation: "sessions";
+                        referencedColumns: ["session_id"];
+                    },
+                    {
+                        foreignKeyName: "execution_logs_user_id_fkey";
+                        columns: ["user_id"];
+                        isOneToOne: false;
+                        referencedRelation: "users";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            execution_metrics: {
+                Row: {
+                    ai_call_count: number;
+                    ai_calls: Json | null;
+                    automation_savings_usd: number | null;
+                    created_at: string | null;
+                    duration_ms: number | null;
+                    execution_id: string;
+                    organization_id: string;
+                    resource_id: string;
+                    total_cost_usd: number;
+                    total_input_tokens: number;
+                    total_output_tokens: number;
+                };
+                Insert: {
+                    ai_call_count: number;
+                    ai_calls?: Json | null;
+                    automation_savings_usd?: number | null;
+                    created_at?: string | null;
+                    duration_ms?: number | null;
+                    execution_id: string;
+                    organization_id: string;
+                    resource_id: string;
+                    total_cost_usd: number;
+                    total_input_tokens: number;
+                    total_output_tokens: number;
+                };
+                Update: {
+                    ai_call_count?: number;
+                    ai_calls?: Json | null;
+                    automation_savings_usd?: number | null;
+                    created_at?: string | null;
+                    duration_ms?: number | null;
+                    execution_id?: string;
+                    organization_id?: string;
+                    resource_id?: string;
+                    total_cost_usd?: number;
+                    total_input_tokens?: number;
+                    total_output_tokens?: number;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "execution_metrics_execution_id_fkey";
+                        columns: ["execution_id"];
+                        isOneToOne: true;
+                        referencedRelation: "execution_logs";
+                        referencedColumns: ["execution_id"];
+                    },
+                    {
+                        foreignKeyName: "execution_metrics_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            notifications: {
+                Row: {
+                    action_url: string | null;
+                    category: string;
+                    created_at: string | null;
+                    id: string;
+                    message: string;
+                    organization_id: string;
+                    read: boolean | null;
+                    read_at: string | null;
+                    title: string;
+                    user_id: string;
+                };
+                Insert: {
+                    action_url?: string | null;
+                    category: string;
+                    created_at?: string | null;
+                    id?: string;
+                    message: string;
+                    organization_id: string;
+                    read?: boolean | null;
+                    read_at?: string | null;
+                    title: string;
+                    user_id: string;
+                };
+                Update: {
+                    action_url?: string | null;
+                    category?: string;
+                    created_at?: string | null;
+                    id?: string;
+                    message?: string;
+                    organization_id?: string;
+                    read?: boolean | null;
+                    read_at?: string | null;
+                    title?: string;
+                    user_id?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "notifications_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "notifications_user_id_fkey";
+                        columns: ["user_id"];
+                        isOneToOne: false;
+                        referencedRelation: "users";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            org_invitations: {
+                Row: {
+                    accept_invitation_url: string | null;
+                    accepted_at: string | null;
+                    created_at: string | null;
+                    email: string;
+                    expires_at: string;
+                    id: string;
+                    invitation_state: string | null;
+                    invitation_token: string | null;
+                    inviter_user_id: string | null;
+                    organization_id: string | null;
+                    revoked_at: string | null;
+                    role_slug: string | null;
+                    updated_at: string | null;
+                    workos_invitation_id: string;
+                };
+                Insert: {
+                    accept_invitation_url?: string | null;
+                    accepted_at?: string | null;
+                    created_at?: string | null;
+                    email: string;
+                    expires_at: string;
+                    id?: string;
+                    invitation_state?: string | null;
+                    invitation_token?: string | null;
+                    inviter_user_id?: string | null;
+                    organization_id?: string | null;
+                    revoked_at?: string | null;
+                    role_slug?: string | null;
+                    updated_at?: string | null;
+                    workos_invitation_id: string;
+                };
+                Update: {
+                    accept_invitation_url?: string | null;
+                    accepted_at?: string | null;
+                    created_at?: string | null;
+                    email?: string;
+                    expires_at?: string;
+                    id?: string;
+                    invitation_state?: string | null;
+                    invitation_token?: string | null;
+                    inviter_user_id?: string | null;
+                    organization_id?: string | null;
+                    revoked_at?: string | null;
+                    role_slug?: string | null;
+                    updated_at?: string | null;
+                    workos_invitation_id?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "org_invitations_inviter_user_id_fkey";
+                        columns: ["inviter_user_id"];
+                        isOneToOne: false;
+                        referencedRelation: "users";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "org_invitations_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            org_memberships: {
+                Row: {
+                    config: Json;
+                    created_at: string | null;
+                    id: string;
+                    membership_status: string | null;
+                    organization_id: string;
+                    role_slug: string | null;
+                    updated_at: string | null;
+                    user_id: string;
+                    workos_membership_id: string | null;
+                };
+                Insert: {
+                    config?: Json;
+                    created_at?: string | null;
+                    id?: string;
+                    membership_status?: string | null;
+                    organization_id: string;
+                    role_slug?: string | null;
+                    updated_at?: string | null;
+                    user_id: string;
+                    workos_membership_id?: string | null;
+                };
+                Update: {
+                    config?: Json;
+                    created_at?: string | null;
+                    id?: string;
+                    membership_status?: string | null;
+                    organization_id?: string;
+                    role_slug?: string | null;
+                    updated_at?: string | null;
+                    user_id?: string;
+                    workos_membership_id?: string | null;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "org_memberships_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "org_memberships_user_id_fkey";
+                        columns: ["user_id"];
+                        isOneToOne: false;
+                        referencedRelation: "users";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            organizations: {
+                Row: {
+                    config: Json;
+                    created_at: string;
+                    id: string;
+                    is_test: boolean;
+                    metadata: Json;
+                    name: string;
+                    status: string;
+                    updated_at: string;
+                    workos_org_id: string;
+                };
+                Insert: {
+                    config?: Json;
+                    created_at?: string;
+                    id?: string;
+                    is_test?: boolean;
+                    metadata?: Json;
+                    name: string;
+                    status?: string;
+                    updated_at?: string;
+                    workos_org_id: string;
+                };
+                Update: {
+                    config?: Json;
+                    created_at?: string;
+                    id?: string;
+                    is_test?: boolean;
+                    metadata?: Json;
+                    name?: string;
+                    status?: string;
+                    updated_at?: string;
+                    workos_org_id?: string;
+                };
+                Relationships: [];
+            };
+            session_messages: {
+                Row: {
+                    created_at: string | null;
+                    id: string;
+                    message: string;
+                    message_index: number | null;
+                    message_type: string | null;
+                    metadata: Json | null;
+                    role: string;
+                    session_id: string;
+                    session_turn_number: number;
+                };
+                Insert: {
+                    created_at?: string | null;
+                    id: string;
+                    message: string;
+                    message_index?: number | null;
+                    message_type?: string | null;
+                    metadata?: Json | null;
+                    role: string;
+                    session_id: string;
+                    session_turn_number: number;
+                };
+                Update: {
+                    created_at?: string | null;
+                    id?: string;
+                    message?: string;
+                    message_index?: number | null;
+                    message_type?: string | null;
+                    metadata?: Json | null;
+                    role?: string;
+                    session_id?: string;
+                    session_turn_number?: number;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "session_messages_session_id_fkey";
+                        columns: ["session_id"];
+                        isOneToOne: false;
+                        referencedRelation: "sessions";
+                        referencedColumns: ["session_id"];
+                    }
+                ];
+            };
+            sessions: {
+                Row: {
+                    context_window_size: number;
+                    created_at: string | null;
+                    cumulative_input_tokens: number;
+                    cumulative_output_tokens: number;
+                    deleted_at: string | null;
+                    ended_at: string | null;
+                    memory_snapshot: Json;
+                    metadata: Json | null;
+                    organization_id: string;
+                    resource_id: string;
+                    session_id: string;
+                    session_total_turns: number | null;
+                    updated_at: string | null;
+                    user_id: string | null;
+                };
+                Insert: {
+                    context_window_size?: number;
+                    created_at?: string | null;
+                    cumulative_input_tokens?: number;
+                    cumulative_output_tokens?: number;
+                    deleted_at?: string | null;
+                    ended_at?: string | null;
+                    memory_snapshot: Json;
+                    metadata?: Json | null;
+                    organization_id: string;
+                    resource_id: string;
+                    session_id?: string;
+                    session_total_turns?: number | null;
+                    updated_at?: string | null;
+                    user_id?: string | null;
+                };
+                Update: {
+                    context_window_size?: number;
+                    created_at?: string | null;
+                    cumulative_input_tokens?: number;
+                    cumulative_output_tokens?: number;
+                    deleted_at?: string | null;
+                    ended_at?: string | null;
+                    memory_snapshot?: Json;
+                    metadata?: Json | null;
+                    organization_id?: string;
+                    resource_id?: string;
+                    session_id?: string;
+                    session_total_turns?: number | null;
+                    updated_at?: string | null;
+                    user_id?: string | null;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "fk_organization";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "fk_user";
+                        columns: ["user_id"];
+                        isOneToOne: false;
+                        referencedRelation: "users";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            task_schedules: {
+                Row: {
+                    created_at: string;
+                    current_step: number;
+                    description: string | null;
+                    id: string;
+                    idempotency_key: string | null;
+                    last_execution_id: string | null;
+                    last_run_at: string | null;
+                    max_retries: number;
+                    metadata: Json | null;
+                    name: string;
+                    next_run_at: string | null;
+                    organization_id: string;
+                    origin_execution_id: string | null;
+                    origin_resource_id: string | null;
+                    origin_resource_type: string | null;
+                    retry_count: number;
+                    schedule_config: Json;
+                    status: string;
+                    target_resource_id: string;
+                    target_resource_type: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    created_at?: string;
+                    current_step?: number;
+                    description?: string | null;
+                    id?: string;
+                    idempotency_key?: string | null;
+                    last_execution_id?: string | null;
+                    last_run_at?: string | null;
+                    max_retries?: number;
+                    metadata?: Json | null;
+                    name: string;
+                    next_run_at?: string | null;
+                    organization_id: string;
+                    origin_execution_id?: string | null;
+                    origin_resource_id?: string | null;
+                    origin_resource_type?: string | null;
+                    retry_count?: number;
+                    schedule_config: Json;
+                    status?: string;
+                    target_resource_id: string;
+                    target_resource_type: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    created_at?: string;
+                    current_step?: number;
+                    description?: string | null;
+                    id?: string;
+                    idempotency_key?: string | null;
+                    last_execution_id?: string | null;
+                    last_run_at?: string | null;
+                    max_retries?: number;
+                    metadata?: Json | null;
+                    name?: string;
+                    next_run_at?: string | null;
+                    organization_id?: string;
+                    origin_execution_id?: string | null;
+                    origin_resource_id?: string | null;
+                    origin_resource_type?: string | null;
+                    retry_count?: number;
+                    schedule_config?: Json;
+                    status?: string;
+                    target_resource_id?: string;
+                    target_resource_type?: string;
+                    updated_at?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "task_schedules_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            users: {
+                Row: {
+                    config: Json;
+                    created_at: string;
+                    display_name: string | null;
+                    email: string;
+                    first_name: string | null;
+                    id: string;
+                    is_active: boolean;
+                    is_platform_admin: boolean | null;
+                    last_login_at: string | null;
+                    last_name: string | null;
+                    last_visited_org: string | null;
+                    profile_picture_url: string | null;
+                    updated_at: string;
+                    workos_user_id: string | null;
+                };
+                Insert: {
+                    config?: Json;
+                    created_at?: string;
+                    display_name?: string | null;
+                    email: string;
+                    first_name?: string | null;
+                    id?: string;
+                    is_active?: boolean;
+                    is_platform_admin?: boolean | null;
+                    last_login_at?: string | null;
+                    last_name?: string | null;
+                    last_visited_org?: string | null;
+                    profile_picture_url?: string | null;
+                    updated_at?: string;
+                    workos_user_id?: string | null;
+                };
+                Update: {
+                    config?: Json;
+                    created_at?: string;
+                    display_name?: string | null;
+                    email?: string;
+                    first_name?: string | null;
+                    id?: string;
+                    is_active?: boolean;
+                    is_platform_admin?: boolean | null;
+                    last_login_at?: string | null;
+                    last_name?: string | null;
+                    last_visited_org?: string | null;
+                    profile_picture_url?: string | null;
+                    updated_at?: string;
+                    workos_user_id?: string | null;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "user_profiles_last_visited_org_fkey";
+                        columns: ["last_visited_org"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            webhook_endpoints: {
+                Row: {
+                    created_at: string;
+                    description: string | null;
+                    id: string;
+                    key: string;
+                    last_triggered_at: string | null;
+                    name: string;
+                    organization_id: string;
+                    request_count: number;
+                    resource_id: string | null;
+                    status: string;
+                    updated_at: string;
+                };
+                Insert: {
+                    created_at?: string;
+                    description?: string | null;
+                    id?: string;
+                    key: string;
+                    last_triggered_at?: string | null;
+                    name: string;
+                    organization_id: string;
+                    request_count?: number;
+                    resource_id?: string | null;
+                    status?: string;
+                    updated_at?: string;
+                };
+                Update: {
+                    created_at?: string;
+                    description?: string | null;
+                    id?: string;
+                    key?: string;
+                    last_triggered_at?: string | null;
+                    name?: string;
+                    organization_id?: string;
+                    request_count?: number;
+                    resource_id?: string | null;
+                    status?: string;
+                    updated_at?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "webhook_endpoints_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+        };
+        Views: {
+            [_ in never]: never;
+        };
+        Functions: {
+            acq_default_checklist: {
+                Args: {
+                    p_platform: string;
+                };
+                Returns: Json;
+            };
+            append_deal_activity: {
+                Args: {
+                    p_activity: Json;
+                    p_deal_id: string;
+                    p_organization_id: string;
+                };
+                Returns: undefined;
+            };
+            auth_jwt_claims: {
+                Args: never;
+                Returns: Json;
+            };
+            auth_uid_safe: {
+                Args: never;
+                Returns: string;
+            };
+            current_user_is_platform_admin: {
+                Args: never;
+                Returns: boolean;
+            };
+            current_user_supabase_id: {
+                Args: never;
+                Returns: string;
+            };
+            detect_stalled_executions: {
+                Args: never;
+                Returns: undefined;
+            };
+            execute_session_turn: {
+                Args: {
+                    p_session_id: string;
+                };
+                Returns: {
+                    created_at: string;
+                    ended_at: string;
+                    memory_snapshot: Json;
+                    metadata: Json;
+                    organization_id: string;
+                    resource_id: string;
+                    session_id: string;
+                    session_total_turns: number;
+                    updated_at: string;
+                    user_id: string;
+                }[];
+            };
+            get_storage_org_id: {
+                Args: {
+                    file_path: string;
+                };
+                Returns: string;
+            };
+            get_workos_user_id: {
+                Args: never;
+                Returns: string;
+            };
+            is_org_admin: {
+                Args: {
+                    org_id: string;
+                };
+                Returns: boolean;
+            };
+            is_org_member: {
+                Args: {
+                    org_id: string;
+                };
+                Returns: boolean;
+            };
+            link_workos_membership_on_accept: {
+                Args: {
+                    p_email: string;
+                    p_organization_id: string;
+                    p_workos_membership_id: string;
+                };
+                Returns: boolean;
+            };
+            pre_provision_invited_user: {
+                Args: {
+                    p_email: string;
+                    p_organization_id: string;
+                    p_role_slug?: string;
+                };
+                Returns: Json;
+            };
+            process_due_schedules: {
+                Args: never;
+                Returns: Json;
+            };
+            upsert_user_profile: {
+                Args: never;
+                Returns: {
+                    profile_display_name: string;
+                    profile_email: string;
+                    profile_id: string;
+                    profile_workos_user_id: string;
+                }[];
+            };
+        };
+        Enums: {
+            [_ in never]: never;
+        };
+        CompositeTypes: {
+            [_ in never]: never;
+        };
+    };
+};
+type DatabaseWithoutInternals = Omit<Database, "__InternalSupabase">;
+type DefaultSchema = DatabaseWithoutInternals[Extract<keyof Database, "public">];
+type Tables<DefaultSchemaTableNameOrOptions extends keyof (DefaultSchema["Tables"] & DefaultSchema["Views"]) | {
+    schema: keyof DatabaseWithoutInternals;
+}, TableName extends DefaultSchemaTableNameOrOptions extends {
+    schema: keyof DatabaseWithoutInternals;
+} ? keyof (DatabaseWithoutInternals[DefaultSchemaTableNameOrOptions["schema"]]["Tables"] & DatabaseWithoutInternals[DefaultSchemaTableNameOrOptions["schema"]]["Views"]) : never = never> = DefaultSchemaTableNameOrOptions extends {
+    schema: keyof DatabaseWithoutInternals;
+} ? (DatabaseWithoutInternals[DefaultSchemaTableNameOrOptions["schema"]]["Tables"] & DatabaseWithoutInternals[DefaultSchemaTableNameOrOptions["schema"]]["Views"])[TableName] extends {
+    Row: infer R;
+} ? R : never : DefaultSchemaTableNameOrOptions extends keyof (DefaultSchema["Tables"] & DefaultSchema["Views"]) ? (DefaultSchema["Tables"] & DefaultSchema["Views"])[DefaultSchemaTableNameOrOptions] extends {
+    Row: infer R;
+} ? R : never : never;
+
+type SupabaseUserProfile = Tables<'users'>;
+
+/**
+ * Action configuration for HITL tasks
+ * Defines available user actions and their behavior
+ */
+interface ActionConfig {
+    /** Unique action identifier (e.g., 'approve', 'retry', 'escalate') */
+    id: string;
+    /** Display label for UI button */
+    label: string;
+    /** Button variant/style */
+    type: 'primary' | 'secondary' | 'danger' | 'outline';
+    /** Tabler icon name (e.g., 'IconCheck', 'IconRefresh') */
+    icon?: string;
+    /** Button color (Mantine theme colors) */
+    color?: string;
+    /** Button variant (Mantine button variant, e.g., 'light', 'filled', 'outline') */
+    variant?: string;
+    /** Execution target (agent/workflow to invoke) */
+    target?: {
+        resourceType: 'agent' | 'workflow';
+        resourceId: string;
+        /**
+         * Optional session ID for agent continuation.
+         * If provided, invokes a new turn on the existing session instead of standalone execution.
+         * Only valid when resourceType is 'agent'.
+         */
+        sessionId?: string;
+    };
+    /** Form schema for collecting action-specific data */
+    form?: FormSchema;
+    /** Payload template for pre-filling forms */
+    payloadTemplate?: unknown;
+    /** Requires confirmation dialog */
+    requiresConfirmation?: boolean;
+    /** Confirmation message */
+    confirmationMessage?: string;
+    /** Help text / tooltip */
+    description?: string;
+}
+
+/**
+ * Origin resource type - where an execution/task originated from.
+ * Used for audit trails and tracking execution lineage.
+ */
+type OriginResourceType = 'agent' | 'workflow' | 'scheduler' | 'api';
+/**
+ * Origin tracking metadata - who/what created this execution/task.
+ * Used by both TaskScheduler and CommandQueue for complete audit trails.
+ */
+interface OriginTracking {
+    originExecutionId: string;
+    originResourceType: OriginResourceType;
+    originResourceId: string;
+}
+
+/**
+ * Command queue task with flexible action system
+ */
+interface Task extends OriginTracking {
+    id: string;
+    organizationId: string;
+    actions: ActionConfig[];
+    context: unknown;
+    selectedAction?: string;
+    actionPayload?: unknown;
+    description?: string;
+    priority: number;
+    /** Optional checkpoint identifier for grouping related human approval tasks */
+    humanCheckpoint?: string;
+    status: TaskStatus;
+    /**
+     * Target resource tracking — mirrors origin columns.
+     * Set when task is created; patchable to redirect execution to a different resource.
+     */
+    targetResourceId?: string;
+    targetResourceType?: 'agent' | 'workflow';
+    /**
+     * Execution ID for the action that runs AFTER user approval.
+     * NULL until execution starts.
+     *
+     * Naming distinction:
+     * - originExecutionId = Parent execution that CREATED the HITL task
+     * - targetExecutionId = Child execution that RUNS AFTER user approval
+     */
+    targetExecutionId?: string;
+    createdAt: Date;
+    completedAt?: Date;
+    completedBy?: string;
+    expiresAt?: Date;
+    idempotencyKey?: string | null;
+}
+/**
+ * Task status values
+ * - pending: awaiting action
+ * - processing: execution in progress after user approval
+ * - completed: action was taken and execution succeeded
+ * - failed: execution failed, task can be retried
+ * - expired: timed out before action
+ */
+type TaskStatus = 'pending' | 'processing' | 'completed' | 'failed' | 'expired';
+/**
+ * Parameters for patching mutable metadata on a task
+ */
+interface PatchTaskParams {
+    humanCheckpoint?: string | null;
+    description?: string;
+    priority?: number;
+    context?: Record<string, unknown>;
+    actions?: unknown[];
+    targetResourceId?: string | null;
+    targetResourceType?: 'agent' | 'workflow' | null;
+    targetExecutionId?: string;
+    status?: 'pending' | 'failed' | 'completed';
+}
+
+/**
+ * Checkpoint list item for sidebar grouping
+ * The id field contains the resourceId of the human checkpoint
+ */
+interface CheckpointListItem {
+    /** Human checkpoint resourceId (or 'ungrouped' for tasks without checkpoint) */
+    id: string;
+    /** Display name (same as id, or "Ungrouped" for null) */
+    name: string;
+    /** Task count for this checkpoint */
+    count: number;
+}
+/**
+ * Status counts for pie chart display
+ */
+interface StatusCounts {
+    pending: number;
+    completed: number;
+    expired: number;
+}
+/**
+ * Priority counts for donut chart display
+ */
+interface PriorityCounts {
+    critical: number;
+    high: number;
+    medium: number;
+    low: number;
+}
+/**
+ * Response from GET /command-queue/checkpoints endpoint
+ */
+interface CheckpointListResponse {
+    checkpoints: CheckpointListItem[];
+    /** Total tasks across all checkpoints */
+    total: number;
+    /** Breakdown by status for donut chart */
+    statusCounts: StatusCounts;
+    /** Breakdown by priority for donut chart */
+    priorityCounts: PriorityCounts;
+}
+
+/**
+ * Target for schedule execution - identifies what resource to execute.
+ * Unlike ExecutionTarget, payload is NOT included here because schedules
+ * store payload in the scheduleConfig (varies per step/item).
+ */
+interface ScheduleTarget {
+    resourceType: 'agent' | 'workflow';
+    resourceId: string;
+}
+/**
+ * Optional origin tracking for schedules.
+ * Unlike OriginTracking (which is required), these fields are all optional
+ * for schedules created directly via API (not triggered by another resource).
+ */
+interface ScheduleOriginTracking {
+    originExecutionId?: string;
+    originResourceType?: OriginResourceType;
+    originResourceId?: string;
+}
+type TaskScheduleConfig = RecurringScheduleConfig | RelativeScheduleConfig | AbsoluteScheduleConfig;
+interface RecurringScheduleConfig {
+    type: 'recurring';
+    cron?: string;
+    interval?: 'daily' | 'weekly' | 'monthly';
+    time?: string;
+    timezone: string;
+    payload: Record<string, unknown>;
+    endAt?: string | null;
+    overduePolicy?: 'skip' | 'execute';
+}
+interface RelativeScheduleConfig {
+    type: 'relative';
+    anchorAt: string;
+    anchorLabel?: string;
+    items: RelativeScheduleItem[];
+    overduePolicy?: 'skip' | 'execute';
+}
+interface RelativeScheduleItem {
+    offset: string;
+    payload: Record<string, unknown>;
+    label?: string;
+}
+interface AbsoluteScheduleConfig {
+    type: 'absolute';
+    items: AbsoluteScheduleItem[];
+    overduePolicy?: 'skip' | 'execute';
+}
+interface AbsoluteScheduleItem {
+    runAt: string;
+    payload: Record<string, unknown>;
+    label?: string;
+}
+interface TaskSchedule extends ScheduleOriginTracking {
+    id: string;
+    organizationId: string;
+    name: string;
+    description?: string;
+    target: ScheduleTarget;
+    scheduleConfig: TaskScheduleConfig;
+    nextRunAt?: Date;
+    currentStep: number;
+    status: 'active' | 'paused' | 'completed' | 'cancelled';
+    lastRunAt?: Date;
+    lastExecutionId?: string;
+    maxRetries: number;
+    idempotencyKey?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+
+/**
+ * Wire-format DTO for notification API responses.
+ * Dates are ISO 8601 strings (not Date objects like the domain Notification type).
+ * Used by frontend hooks that consume /api/notifications.
+ */
+interface NotificationDTO {
+    id: string;
+    userId: string;
+    organizationId: string;
+    category: string;
+    title: string;
+    message: string;
+    actionUrl: string | null;
+    read: boolean;
+    readAt: string | null;
+    createdAt: string;
+}
+
+/**
+ * Session Data Transfer Object (DTO)
+ * Transform type for API responses (snake_case DB → camelCase frontend)
+ * Used by frontend apps to display session data
+ */
+interface SessionDTO {
+    sessionId: string;
+    resourceId: string;
+    organizationId: string;
+    userId?: string | null;
+    turnCount: number;
+    isEnded: boolean;
+    title?: string | null;
+    memorySnapshot?: AgentMemory;
+    metadata?: Record<string, unknown> | null;
+    createdAt: Date;
+    updatedAt: Date;
+    endedAt?: Date | null;
+}
+
+/**
+ * Multi-tenancy configuration types
+ *
+ * Config is stored in dedicated `config` columns (NOT nested in metadata):
+ * - organizations.config: Org-level feature config
+ * - org_memberships.config: Per-user-per-org feature overrides
+ * - users.config: User-global config
+ */
+/**
+ * Org-level feature config (stored in organizations.config)
+ * Controls which features are available to all org members
+ * Valid feature keys: operations, monitoring, acquisition, calibration, seo
+ */
+interface OrgFeatureConfig {
+    features?: {
+        operations?: boolean;
+        monitoring?: boolean;
+        acquisition?: boolean;
+        calibration?: boolean;
+        seo?: boolean;
+    };
+}
+/**
+ * Per-user-per-org config (stored in org_memberships.config)
+ * Overrides org-level feature config for specific users
+ */
+type MembershipFeatureConfig = OrgFeatureConfig;
+/**
+ * User-global config (stored in users.config)
+ * Theme and onboarding are user-specific, NOT org-specific
+ */
+interface UserConfig {
+    theme?: {
+        preset?: 'default' | 'tactical' | 'regal' | 'cyber-volt' | 'aurora' | 'rose-gold' | 'midnight' | 'ember' | 'obsidian' | 'honey' | 'abyss' | 'canopy' | 'slate' | 'cyber-strike' | 'cyber-flux' | 'cyber-void';
+        colorScheme?: 'light' | 'dark' | 'auto';
+    };
+    onboarding?: {
+        completed?: boolean;
+        completedAt?: string;
+        role?: string;
+        primaryUseCase?: string[];
+        experienceLevel?: string;
+        /** Onboarding guide system state (set by checklist/tour system) */
+        guides?: {
+            completedIds?: string[];
+            dismissed?: boolean;
+            completedAt?: string;
+        };
+    };
+}
+
+/**
+ * Organization Membership types based on WorkOS API
+ */
+interface OrganizationMembership {
+    object: 'organization_membership';
+    id: string;
+    userId: string;
+    organizationId: string;
+    role: {
+        slug: string;
+    };
+    status: 'active' | 'inactive';
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Extended membership with user and organization details for UI
+ */
+interface MembershipWithDetails extends OrganizationMembership {
+    user?: {
+        id: string;
+        email: string;
+        firstName?: string;
+        lastName?: string;
+        profilePictureUrl?: string;
+    };
+    organization?: {
+        id: string;
+        name: string;
+        workos_org_id: string;
+        primaryDomain?: string;
+        is_test?: boolean;
+        status?: string;
+        metadata?: Record<string, unknown>;
+        config?: OrgFeatureConfig;
+    };
+    config?: MembershipFeatureConfig;
+}
+
+/**
+ * Time range selector for dashboard metrics
+ */
+type TimeRange = '1h' | '24h' | '7d' | '30d';
+/**
+ * Execution health metrics response
+ * Success rate, P95 duration, execution counts, and trend data
+ * trendData includes executionCount for throughput visualization (eliminates separate API call)
+ */
+interface ExecutionHealthMetrics {
+    successRate: number;
+    p95Duration: number;
+    totalExecutions: number;
+    trendData: Array<{
+        time: string;
+        rate: number;
+        successCount: number;
+        errorCount: number;
+        warningCount: number;
+        executionCount: number;
+    }>;
+    statusCounts: {
+        success: number;
+        failed: number;
+        pending: number;
+        warning: number;
+    };
+    peakPeriod: string;
+    granularity: 'hour' | 'day';
+}
+/**
+ * Error analysis metrics response
+ * Error categories and top failing resources
+ */
+interface ErrorAnalysisMetrics {
+    totalErrors: number;
+    errorsByCategory: Array<{
+        category: string;
+        count: number;
+        percentage: number;
+    }>;
+    topFailingResources: Array<{
+        resourceId: string;
+        name: string;
+        errorCount: number;
+        failureRate: number;
+    }>;
+}
+/**
+ * Business impact metrics response
+ * ROI, labor savings, and cost analysis
+ */
+interface BusinessImpactMetrics$1 {
+    totalSavingsUsd: number;
+    totalCostUsd: number;
+    netSavingsUsd: number;
+    roi: number;
+}
+/**
+ * Cost breakdown metrics response
+ * Per-resource cost analysis
+ */
+interface CostBreakdownMetrics {
+    resources: Array<{
+        resourceId: string;
+        totalCostUsd: number;
+        executionCount: number;
+        avgCostUsd: number;
+    }>;
+}
+/**
+ * Dashboard metrics response
+ * Aggregates core observability metrics in a single response
+ * Note: Throughput data is now included in executionHealth.trendData.executionCount
+ */
+interface DashboardMetrics {
+    executionHealth: ExecutionHealthMetrics;
+    costBreakdown: CostBreakdownMetrics;
+    businessImpact: BusinessImpactMetrics$1;
+    /** ISO timestamp of the currently active deployment, or null if none */
+    activeDeploymentDate: string | null;
+    /** Deployment version of the active deployment, or null if none */
+    activeDeploymentVersion: string | null;
+}
+/**
+ * Error record for list view (ErrorBreakdownTable)
+ */
+interface ErrorRecord {
+    id: string;
+    timestamp: string;
+    errorType: string;
+    message: string;
+    executionId: string;
+    resourceId: string;
+    resourceName: string;
+    severity: 'critical' | 'warning' | 'info';
+    category: ExecutionErrorCategory;
+    resolved: boolean;
+    resolvedAt: string | null;
+    resolvedBy: string | null;
+}
+/**
+ * Full error detail for modal view (ErrorDetailsModal)
+ */
+interface ErrorDetailFull extends ErrorRecord {
+    stackTrace?: string;
+    retryAttempt?: number;
+    stepName?: string;
+    stepSequence?: number;
+    errorContext?: Record<string, unknown>;
+    executionContext?: Record<string, unknown>;
+}
+/**
+ * Error details API response (paginated)
+ */
+interface ErrorDetailResponse {
+    errors: ErrorRecord[];
+    total: number;
+    page: number;
+    limit: number;
+}
+/**
+ * Error trend data for time-series charts
+ */
+interface ErrorTrend {
+    time: string;
+    errorCount: number;
+    criticalCount: number;
+    warningCount: number;
+    infoCount: number;
+}
+/**
+ * Cost trend data point for time-series charts
+ * Represents a single time bucket (hour or day)
+ */
+interface CostTrendDataPoint {
+    time: string;
+    totalCostUsd: number;
+    executionCount: number;
+    avgCostPerExecution: number;
+}
+/**
+ * Cost trends response (time-series data)
+ */
+interface CostTrendsResponse {
+    trendData: CostTrendDataPoint[];
+    granularity: 'hour' | 'day';
+    totalCostUsd: number;
+    totalExecutions: number;
+}
+/**
+ * Cost summary response with MTD and projections
+ */
+interface CostSummaryResponse {
+    current: {
+        totalCostUsd: number;
+        executionCount: number;
+    };
+    previous: {
+        totalCostUsd: number;
+        executionCount: number;
+    };
+    mtd: {
+        totalCostUsd: number;
+        daysElapsed: number;
+    };
+    projection: {
+        monthlyCostUsd: number;
+        confidence: 'low' | 'medium' | 'high';
+    };
+    trend: {
+        changePercent: number;
+        direction: 'up' | 'down' | 'flat';
+    };
+}
+/**
+ * Cost by model data for model-level breakdown
+ */
+interface CostByModelData {
+    model: string;
+    totalCostUsd: number;
+    callCount: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    avgCostPerCall: number;
+}
+/**
+ * Cost by model response
+ */
+interface CostByModelResponse {
+    models: CostByModelData[];
+    totalCostUsd: number;
+    totalCallCount: number;
+}
+
+/**
+ * Base Execution Engine type definitions
+ * Core types shared across all Execution Engine resources
+ */
+
+/**
+ * NOTE: AIResource interface has been removed and replaced with ResourceDefinition
+ * from registry/types.ts. All resources (executable and non-executable) now extend
+ * the unified ResourceDefinition base interface.
+ *
+ * AgentConfig and WorkflowConfig now extend ResourceDefinition directly.
+ * See packages/core/src/registry/types.ts for the base interface definition.
+ */
+type AIResourceDefinition = SerializedWorkflowDefinition | SerializedAgentDefinition;
+
+/**
+ * Resource Registry type definitions
+ */
+
+/**
+ * Environment/deployment status for resources
+ */
+type ResourceStatus$1 = 'dev' | 'prod';
+/**
+ * All resource types in the platform
+ * Used as the discriminator field in ResourceDefinition
+ */
+type ResourceType$1 = 'agent' | 'workflow' | 'trigger' | 'integration' | 'external' | 'human';
+/**
+ * Base interface for ALL platform resources
+ * Shared by both executable (agents, workflows) and non-executable (triggers, integrations, etc.) resources
+ */
+interface ResourceDefinition {
+    /** Unique resource identifier */
+    resourceId: string;
+    /** Display name */
+    name: string;
+    /** Purpose and functionality description */
+    description: string;
+    /** Version for change tracking and evolution */
+    version: string;
+    /** Resource type discriminator */
+    type: ResourceType$1;
+    /** Environment/deployment status */
+    status: ResourceStatus$1;
+    /** Domain tags for filtering and organization */
+    domains?: ResourceDomain[];
+    /** Whether the agent supports multi-turn sessions (agents only) */
+    sessionCapable?: boolean;
+    /** Whether the resource is local (monorepo) or remote (externally deployed) */
+    origin?: 'local' | 'remote';
+    /** Whether this resource is archived and should be excluded from registration and deployment */
+    archived?: boolean;
+}
+
+/**
+ * Standard Domain Definitions
+ * Centralized domain constants and definitions for all organization resources.
+ */
+
+declare const DOMAINS: {
+    readonly INBOUND_PIPELINE: "inbound-pipeline";
+    readonly LEAD_GEN_PIPELINE: "lead-gen-pipeline";
+    readonly SUPPORT: "support";
+    readonly CLIENT_SUPPORT: "client-support";
+    readonly DELIVERY: "delivery";
+    readonly OPERATIONS: "operations";
+    readonly FINANCE: "finance";
+    readonly EXECUTIVE: "executive";
+    readonly INSTANTLY: "instantly";
+    readonly TESTING: "testing";
+    readonly INTERNAL: "internal";
+    readonly INTEGRATION: "integration";
+    readonly UTILITY: "utility";
+    readonly DIAGNOSTIC: "diagnostic";
+};
+/**
+ * ResourceDomain - Strongly typed domain identifier
+ * Use this type for all domain references to ensure compile-time validation.
+ */
+type ResourceDomain = (typeof DOMAINS)[keyof typeof DOMAINS];
+
+type ExecutionStatus$1 = 'pending' | 'running' | 'completed' | 'failed' | 'warning';
+
+type ActivityType = 'workflow_execution' | 'agent_run' | 'hitl_action' | 'webhook_received' | 'webhook_executed' | 'webhook_failed' | 'credential_change' | 'api_key_change' | 'deployment_change' | 'membership_change';
+type ActivityStatus = 'success' | 'failure' | 'pending' | 'approved' | 'rejected' | 'completed';
+interface Activity {
+    id: string;
+    organizationId: string;
+    activityType: ActivityType;
+    status: ActivityStatus;
+    title: string;
+    description: string | null;
+    entityType: string;
+    entityId: string;
+    entityName: string | null;
+    metadata: Record<string, unknown> | null;
+    actorId: string | null;
+    actorType: string | null;
+    occurredAt: Date;
+    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>;
+
+declare function useCommandQueue({ status, limit, offset, humanCheckpoint, timeRange, priorityMin, priorityMax, }?: {
+    status?: TaskStatus;
+    limit?: number;
+    offset?: number;
+    humanCheckpoint?: string;
+    timeRange?: TimeRange;
+    priorityMin?: number;
+    priorityMax?: number;
+}): _tanstack_react_query.UseQueryResult<{
+    createdAt: Date;
+    completedAt: Date | undefined;
+    expiresAt: Date | undefined;
+    id: string;
+    organizationId: string;
+    actions: ActionConfig[];
+    context: unknown;
+    selectedAction?: string;
+    actionPayload?: unknown;
+    description?: string;
+    priority: number;
+    humanCheckpoint?: string;
+    status: TaskStatus;
+    targetResourceId?: string;
+    targetResourceType?: "agent" | "workflow";
+    targetExecutionId?: string;
+    completedBy?: string;
+    idempotencyKey?: string | null;
+    originExecutionId: string;
+    originResourceType: OriginResourceType;
+    originResourceId: string;
+}[], Error>;
+
+interface SubmitActionRequest {
+    taskId: string;
+    actionId: string;
+    payload?: unknown;
+    notes?: string;
+}
+interface OptimisticContext {
+    previousData: Map<readonly unknown[], Task[] | undefined>;
+}
+interface ExecutionErrorDetails {
+    message: string;
+    type: string;
+    severity: 'critical' | 'warning' | 'info';
+    category: 'llm' | 'tool' | 'workflow' | 'agent' | 'validation' | 'system';
+    details?: string;
+}
+interface SubmitActionResponse {
+    task: unknown;
+    execution?: {
+        executionId: string;
+        success: boolean;
+        data?: unknown;
+        error?: ExecutionErrorDetails;
+    };
+}
+declare function useSubmitAction(): _tanstack_react_query.UseMutationResult<SubmitActionResponse, Error, SubmitActionRequest, OptimisticContext>;
+
+declare function useDeleteTask(): _tanstack_react_query.UseMutationResult<void, Error, string, {
+    previousData: Map<readonly unknown[], Task[] | undefined>;
+}>;
+
+interface UseCommandQueueTotalsOptions {
+    timeRange?: TimeRange;
+    priorityMin?: number;
+    priorityMax?: number;
+    /** When set, priorityCounts are scoped to this status only */
+    status?: 'pending' | 'completed' | 'expired';
+}
+/**
+ * Fetches command queue totals and checkpoint groupings
+ *
+ * Returns distinct human checkpoints with task counts and status breakdown.
+ * Used for sidebar grouping and donut charts (true totals, not paginated).
+ */
+declare function useCommandQueueTotals({ timeRange, priorityMin, priorityMax, status }?: UseCommandQueueTotalsOptions): _tanstack_react_query.UseQueryResult<CheckpointListResponse, Error>;
+
+declare function usePatchTask(): _tanstack_react_query.UseMutationResult<Task, Error, {
+    taskId: string;
+    params: PatchTaskParams;
+}, unknown>;
+
+/**
+ * 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];
+    executions: (orgId: string | null, resourceId: string) => readonly ["executions", "list", string | null, string];
+    execution: (orgId: string | null, resourceId: string, executionId: string) => readonly ["executions", "execution", string | null, string, string];
+};
+
+/**
+ * Workflow-specific logging types and utilities
+ */
+
+
+
+// Workflow start/end log context
+interface WorkflowExecutionContext {
+  type: 'workflow'
+  contextType: 'workflow-execution'
+  executionId: string
+  workflowId: string
+  workflowName?: string
+  organizationId: string
+  executionPath?: string[]
+}
+
+// Workflow failure log context
+interface WorkflowFailureContext {
+  type: 'workflow'
+  contextType: 'workflow-failure'
+  executionId: string
+  workflowId: string
+  error: string
+}
+
+// Step started log context
+interface StepStartedContext {
+  type: 'workflow'
+  contextType: 'step-started'
+  stepId: string
+  stepStatus: 'started'
+  input: unknown
+  startTime: number // Explicit start timestamp for timeline
+}
+
+// Step completed log context
+interface StepCompletedContext {
+  type: 'workflow'
+  contextType: 'step-completed'
+  stepId: string
+  stepStatus: 'completed'
+  output: unknown
+  duration: number
+  isTerminal: boolean
+  startTime: number // Explicit start timestamp for timeline
+  endTime: number // Explicit end timestamp for timeline
+}
+
+// Step failed log context
+interface StepFailedContext {
+  type: 'workflow'
+  contextType: 'step-failed'
+  stepId: string
+  stepStatus: 'failed'
+  error: string
+  duration: number
+  startTime: number // Explicit start timestamp for timeline
+  endTime: number // Explicit end timestamp for timeline
+}
+
+// Conditional routing log context
+interface ConditionalRouteContext {
+  type: 'workflow'
+  contextType: 'conditional-route'
+  stepId: string
+  target: string
+  error?: string
+}
+
+// Execution path log context
+interface ExecutionPathContext {
+  type: 'workflow'
+  contextType: 'execution-path'
+  executionPath: string[]
+}
+
+// Union of all workflow log contexts
+type WorkflowLogContext =
+  | WorkflowExecutionContext
+  | WorkflowFailureContext
+  | StepStartedContext
+  | StepCompletedContext
+  | StepFailedContext
+  | ConditionalRouteContext
+  | ExecutionPathContext
+
+/**
+ * Agent-specific logging types
+ * Simplified 2-event model: lifecycle, iteration
+ *
+ * Design Philosophy:
+ * - LIFECYCLE EVENTS: Structural checkpoints (initialization, iteration, completion)
+ * - ITERATION EVENTS: Execution activities (reasoning, actions during iterations)
+ */
+
+
+
+// ============================================================================
+// FORMAL TYPES
+// ============================================================================
+
+/**
+ * Agent lifecycle stages
+ * Universal checkpoints that apply to all agent executions
+ */
+type AgentLifecycle = 'initialization' | 'iteration' | 'completion'
+
+/**
+ * Iteration event types
+ * Activities that occur during agent iterations
+ */
+type IterationEventType = 'reasoning' | 'action' | 'tool-call'
+
+// ============================================================================
+// LIFECYCLE EVENTS (Structural Checkpoints)
+// ============================================================================
+
+/**
+ * Base fields shared by all lifecycle events
+ */
+interface AgentLifecycleEventBase {
+  type: 'agent'
+  agentId: string
+  lifecycle: AgentLifecycle
+  sessionId?: string // Optional: only present when agent runs in session context
+}
+
+/**
+ * Lifecycle started event - emitted when a phase begins
+ * REQUIRED: startTime (phase has started, no end yet)
+ */
+interface AgentLifecycleStartedEvent extends AgentLifecycleEventBase {
+  stage: 'started'
+  startTime: number // REQUIRED: Phase start timestamp
+  iteration?: number // Only for 'iteration' lifecycle
+}
+
+/**
+ * Lifecycle completed event - emitted when a phase succeeds
+ * REQUIRED: startTime, endTime, duration (phase has finished successfully)
+ */
+interface AgentLifecycleCompletedEvent extends AgentLifecycleEventBase {
+  stage: 'completed'
+  startTime: number // REQUIRED: Phase start timestamp
+  endTime: number // REQUIRED: Phase end timestamp
+  duration: number // REQUIRED: Calculated duration (endTime - startTime)
+  iteration?: number // Only for 'iteration' lifecycle
+
+  // Optional fields specific to certain lifecycles
+  attempts?: number // Only for 'completion' lifecycle (tracks output generation attempts: 1 or 2)
+  memorySize?: {
+    sessionMemoryKeys: number
+    historyEntries: number
+  } // Only for 'completion' lifecycle (memory snapshot metadata)
+}
+
+/**
+ * Lifecycle failed event - emitted when a phase fails
+ * REQUIRED: startTime, endTime, duration, error (phase has finished with error)
+ */
+interface AgentLifecycleFailedEvent extends AgentLifecycleEventBase {
+  stage: 'failed'
+  startTime: number // REQUIRED: Phase start timestamp
+  endTime: number // REQUIRED: Phase end timestamp
+  duration: number // REQUIRED: Calculated duration (endTime - startTime)
+  error: string // REQUIRED: Error message
+  iteration?: number // Only for 'iteration' lifecycle
+}
+
+/**
+ * Union type for all lifecycle events
+ * Discriminated by 'stage' field for type narrowing
+ */
+type AgentLifecycleEvent = AgentLifecycleStartedEvent | AgentLifecycleCompletedEvent | AgentLifecycleFailedEvent
+
+// ============================================================================
+// ITERATION EVENTS (Execution Activities)
+// ============================================================================
+
+/**
+ * Placeholder data for MVP
+ * Will be typed per actionType in future
+ */
+interface ActionPlaceholderData {
+  message: string
+}
+
+/**
+ * Iteration event - captures activities during agent iterations
+ * Consolidates reasoning (LLM thought process) and actions (tool use, memory ops, etc.)
+ */
+interface AgentIterationEvent {
+  type: 'agent'
+  agentId: string
+  lifecycle: 'iteration' // Always iteration
+  eventType: IterationEventType
+  iteration: number
+  sessionId?: string // Optional: only present when agent runs in session context
+
+  // Timeline timing fields (v2 - Clean Break)
+  startTime: number // Activity start timestamp
+  endTime: number // Activity end timestamp
+  duration: number // Calculated duration (endTime - startTime)
+
+  // Conditional fields based on eventType
+  output?: string // For reasoning events
+  actionType?: string // For action events (tool-use, delegate, memory-write, etc.)
+  data?: ActionPlaceholderData // For action events
+}
+
+/**
+ * Tool call event - captures individual tool executions during iterations
+ * Provides granular timing for each tool invocation
+ */
+interface AgentToolCallEvent {
+  type: 'agent'
+  agentId: string
+  lifecycle: 'iteration' // Always iteration
+  eventType: 'tool-call' // Specific event type for tool calls
+  iteration: number
+  sessionId?: string // Optional: only present when agent runs in session context
+
+  // Tool identification and timing
+  toolName: string // Tool identifier
+  startTime: number // Tool call start timestamp
+  endTime: number // Tool call end timestamp
+  duration: number // Calculated duration
+
+  // Execution results
+  success: boolean // Whether tool execution succeeded
+  error?: string // Error message if failed
+  input?: Record<string, unknown> // Tool input parameters
+  output?: unknown // Tool output result
+}
+
+// ============================================================================
+// UNION TYPES
+// ============================================================================
+
+/**
+ * Union type for all agent log contexts
+ * 3 event types total (lifecycle, iteration, tool-call)
+ */
+type AgentLogContext = AgentLifecycleEvent | AgentIterationEvent | AgentToolCallEvent
+
+/**
+ * Base execution logger for Execution Engine
+ */
+type ExecutionLogLevel = 'debug' | 'info' | 'warn' | 'error'
+
+
+// Union type for all contexts
+type LogContext = WorkflowLogContext | AgentLogContext
+
+// Updated interface with consolidated context
+interface ExecutionLogMessage {
+  level: ExecutionLogLevel
+  message: string
+  timestamp: number
+  context?: LogContext
+}
+
+/**
+ * Resource Registry type definitions
+ */
+
+
+
+// ============================================================================
+// Core Resource Type Definitions
+// ============================================================================
+
+/**
+ * Environment/deployment status for resources
+ */
+type ResourceStatus = 'dev' | 'prod'
+
+/**
+ * All resource types in the platform
+ * Used as the discriminator field in ResourceDefinition
+ */
+type ResourceType = 'agent' | 'workflow' | 'trigger' | 'integration' | 'external' | 'human'
+
+// Execution status type shared between API and UI
+type ExecutionStatus = 'pending' | 'running' | 'completed' | 'failed' | 'warning'
+
+// API execution types
+interface APIExecutionSummary {
+  id: string
+  status: ExecutionStatus
+  startTime: number
+  endTime?: number
+  resourceStatus?: ResourceStatus // 'dev' | 'prod' - optional for backward compatibility
+}
+
+interface APIExecutionDetail extends APIExecutionSummary {
+  executionLogs: ExecutionLogMessage[]
+  input?: unknown
+  result?: unknown
+  error?: string
+  resourceStatus: ResourceStatus // Required in detail view
+  apiVersion?: string | null
+  resourceVersion?: string | null
+  sdkVersion?: string | null
+}
+
+// API request/response types
+interface APIExecutionListResponse {
+  executions: APIExecutionSummary[]
+}
+
+/**
+ * Fetch the execution list for a given resource.
+ *
+ * resourceStatus and limit are intentionally excluded from the query key so that
+ * SSE invalidations (which target the unfiltered key) bust all filter variants.
+ *
+ * @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): _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;
+}
+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 RetryExecutionParams {
+    resourceId: string;
+    resourceType: ResourceType;
+    input: unknown;
+}
+/**
+ * Retry a failed execution by re-triggering it async.
+ * Functionally identical to useExecuteAsync but named for intent clarity at call sites.
+ */
+declare function useRetryExecution(): _tanstack_react_query.UseMutationResult<{
+    resourceId: string;
+    executionId: string;
+    status: string;
+}, Error, RetryExecutionParams, unknown>;
+
+interface CancelExecutionParams {
+    resourceId: string;
+    executionId: string;
+}
+interface CancelExecutionResult {
+    cancelled: boolean;
+    method: string;
+    resourceId: string;
+    executionId: string;
+}
+/**
+ * Cancel a running execution.
+ * Invalidates both the execution detail and the executions list on success.
+ *
+ * @example
+ * const { mutate: cancel, isPending } = useCancelExecution()
+ * cancel({ resourceId, executionId })
+ */
+declare function useCancelExecution(): _tanstack_react_query.UseMutationResult<CancelExecutionResult, Error, CancelExecutionParams, unknown>;
+
+interface DeleteExecutionParams {
+    resourceId: string;
+    executionId: string;
+}
+/**
+ * Delete a single execution record.
+ * Removes the execution from cache immediately and invalidates the list.
+ */
+declare function useDeleteExecution(): _tanstack_react_query.UseMutationResult<{
+    resourceId: string;
+    executionId: string;
+}, Error, DeleteExecutionParams, unknown>;
+
+interface BulkDeleteExecutionsParams {
+    resourceId: string;
+    resourceStatus?: ResourceStatus | 'all';
+}
+interface BulkDeleteExecutionsResult {
+    resourceId: string;
+    deletedCount: number;
+    resourceStatus?: ResourceStatus | 'all';
+}
+/**
+ * Bulk delete executions for a resource, optionally filtered by status.
+ */
+declare function useBulkDeleteExecutions(): _tanstack_react_query.UseMutationResult<BulkDeleteExecutionsResult, Error, BulkDeleteExecutionsParams, unknown>;
+
+/**
+ * Fetch all available Execution Engine resources (workflows, agents, pipelines).
+ *
+ * @example
+ * const { data, isLoading } = useResources()
+ * const workflows = data?.workflows ?? []
+ * const agents = data?.agents ?? []
+ */
+declare function useResources(): _tanstack_react_query.UseQueryResult<{
+    workflows: ResourceDefinition[];
+    agents: ResourceDefinition[];
+    pipelines: ResourceDefinition[];
+    total: number;
+}, Error>;
+
+/**
+ * Fetch a resource definition (workflow steps, agent actions, etc.).
+ *
+ * @param resourceId - The resource ID to fetch
+ * @param enabled - Whether the query should execute (default: true)
+ */
+declare function useResourceDefinition(resourceId: string, enabled?: boolean): _tanstack_react_query.UseQueryResult<AIResourceDefinition, Error>;
+
+interface UseActivitiesParams {
+    limit?: number;
+    offset?: number;
+    activityType?: ActivityType;
+    entityType?: string;
+    entityId?: string;
+    startDate?: string;
+    endDate?: string;
+    status?: string;
+    search?: string;
+}
+interface ListActivitiesResponse {
+    activities: Activity[];
+    total: number;
+}
+/**
+ * Fetch activities with filtering and pagination
+ *
+ * @example
+ * // Basic usage - fetch recent activities
+ * const { data, error, isLoading } = useActivities({ limit: 50 })
+ *
+ * @example
+ * // Filtered by type
+ * const { data } = useActivities({
+ *   activityType: 'workflow_execution',
+ *   limit: 20
+ * })
+ *
+ * @example
+ * // Filtered by entity
+ * const { data } = useActivities({
+ *   entityType: 'workflow',
+ *   entityId: 'workflow-123'
+ * })
+ */
+interface ActivityTrendResponse {
+    timestamps: Date[];
+    total: number;
+}
+type UseActivityTrendParams = Omit<UseActivitiesParams, 'limit' | 'offset' | 'search' | 'status'>;
+/**
+ * Fetch activity timestamps for the Activity Trend chart
+ *
+ * Uses /activities/trend endpoint which returns only occurred_at timestamps
+ * up to ANALYTICS_SAFETY_LIMIT (10,000), bypassing the MAX_PAGE_LIMIT cap.
+ * Provides accurate counts for any time range regardless of activity volume.
+ */
+declare function useActivityTrend(params?: UseActivityTrendParams): _tanstack_react_query.UseQueryResult<ActivityTrendResponse, Error>;
+declare function useActivities(params?: UseActivitiesParams): _tanstack_react_query.UseQueryResult<ListActivitiesResponse, Error>;
+
+interface UseExecutionLogsParams {
+    resourceId?: string;
+    status?: ExecutionStatus$1 | 'all';
+    resourceStatus?: 'dev' | 'prod' | 'all';
+    startDate?: number;
+    endDate?: number;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Response type for cross-resource execution list
+ * Matches backend ExecutionLogsPageResponse in apps/api/src/execution-engine/handlers.ts
+ */
+interface ExecutionLogsPageResponse {
+    executions: Array<{
+        id: string;
+        resourceId: string;
+        resourceName: string;
+        resourceType: 'workflow' | 'agent' | 'pipeline';
+        status: ExecutionStatus$1;
+        startTime: number;
+        endTime?: number;
+        duration?: number;
+        resourceStatus: 'dev' | 'prod';
+        resourceVersion?: string | null;
+        apiVersion?: string | null;
+        sdkVersion?: string | null;
+    }>;
+    total: number;
+    hasMore: boolean;
+}
+/**
+ * Fetch execution logs across all resources with filtering and pagination
+ *
+ * @example
+ * // Basic usage - fetch recent executions
+ * const { data, error, isLoading } = useExecutionLogs({ limit: 50 })
+ *
+ * @example
+ * // Filtered by status
+ * const { data } = useExecutionLogs({
+ *   status: 'failed',
+ *   limit: 20
+ * })
+ *
+ * @example
+ * // Filtered by resource and date range
+ * const { data } = useExecutionLogs({
+ *   resourceId: 'workflow-123',
+ *   startDate: Date.now() - 86400000, // Last 24 hours
+ *   endDate: Date.now()
+ * })
+ */
+declare function useExecutionLogs(params?: UseExecutionLogsParams): _tanstack_react_query.UseQueryResult<ExecutionLogsPageResponse, Error>;
+
+interface UseNotificationsOptions {
+    limit?: number;
+    offset?: number;
+}
+declare function useNotifications({ limit, offset }?: UseNotificationsOptions): _tanstack_react_query.UseQueryResult<{
+    notifications: NotificationDTO[];
+    total: number;
+}, Error>;
+
+declare function useCostSummary(timeRange: TimeRange): _tanstack_react_query.UseQueryResult<CostSummaryResponse, Error>;
+
+interface UseExecutionHealthParams {
+    timeRange: TimeRange;
+}
+declare function useExecutionHealth({ timeRange }: UseExecutionHealthParams): _tanstack_react_query.UseQueryResult<DashboardMetrics, Error>;
+
+declare function useMarkAsRead(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+
+declare function useMarkAllAsRead(): _tanstack_react_query.UseMutationResult<void, Error, void, unknown>;
+
+/**
+ * API-only hook for unread notification count.
+ *
+ * For SSE-enhanced real-time counts, consumers should provide
+ * the count via props (e.g., NotificationBell's `unreadCount` prop).
+ */
+declare function useNotificationCount(): _tanstack_react_query.UseQueryResult<number, Error>;
+
+/**
+ * Hook that provides a standardized error notification handler
+ * for use in React Query mutation hooks.
+ *
+ * Delegates to the active NotificationAdapter so it works in any
+ * consumer (Mantine, Sonner, console fallback, etc.)
+ *
+ * @example
+ * ```typescript
+ * const mutation = useMutation({
+ *   mutationFn: deleteApiKey,
+ *   onError: useErrorNotification()
+ * })
+ * ```
+ */
+declare function useErrorNotification(): (error: unknown) => void;
+
+/**
+ * Hook that provides a standardized success notification handler.
+ * Delegates to the active NotificationAdapter.
+ */
+declare function useSuccessNotification(): (title: string, message: string) => void;
+
+/**
+ * Hook that provides a standardized warning notification handler.
+ * Delegates to the active NotificationAdapter.
+ */
+declare function useWarningNotification(): (title: string, message: string) => void;
+
+/**
+ * Generic batch delete hook. Deletes multiple rows from a Supabase table by ID.
+ *
+ * @param tableName - Supabase table name (e.g. 'acq_social_posts')
+ * @param invalidateQueryKeys - Array of query key prefixes to invalidate on success
+ */
+declare function useBatchDelete(tableName: string, invalidateQueryKeys: readonly (readonly unknown[])[]): _tanstack_react_query.UseMutationResult<void, Error, string[], unknown>;
+
+/**
+ * Query key factories for observability hooks.
+ * Scoped by organizationId for cache isolation between tenants.
+ */
+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];
+};
+
+declare function useErrorAnalysis(timeRange: TimeRange): _tanstack_react_query.UseQueryResult<ErrorAnalysisMetrics, Error>;
+
+interface ErrorFilters {
+    errorType?: string;
+    severity?: 'critical' | 'warning' | 'info';
+    search?: string;
+    startDate?: string;
+    endDate?: string;
+    page?: number;
+    limit?: number;
+    /** When true, show only resolved errors. When false, show only unresolved. Omit to show all. */
+    resolved?: boolean;
+}
+declare function useErrorDetails(filters: ErrorFilters): _tanstack_react_query.UseQueryResult<ErrorDetailResponse, Error>;
+declare function useErrorDetail(executionId: string | null): _tanstack_react_query.UseQueryResult<ErrorDetailFull[] | null, Error>;
+
+interface ErrorTrendsParams {
+    startDate: string;
+    endDate: string;
+    granularity: 'hour' | 'day';
+}
+declare function useErrorTrends({ startDate, endDate, granularity }: ErrorTrendsParams): _tanstack_react_query.UseQueryResult<ErrorTrend[], Error>;
+
+interface ErrorDistributionParams {
+    startDate: string;
+    endDate: string;
+    groupBy: 'errorType' | 'resource' | 'severity';
+}
+interface ErrorDistributionItem {
+    label: string;
+    count: number;
+    percentage: number;
+}
+declare function useErrorDistribution({ startDate, endDate, groupBy }: ErrorDistributionParams): _tanstack_react_query.UseQueryResult<ErrorDistributionItem[], Error>;
+
+interface TopFailingResourcesParams {
+    startDate: string;
+    endDate: string;
+    limit?: number;
+}
+interface FailingResource {
+    resourceId: string;
+    resourceType: string;
+    errorCount: number;
+    failureRate: number;
+}
+declare function useTopFailingResources({ startDate, endDate, limit }: TopFailingResourcesParams): _tanstack_react_query.UseQueryResult<FailingResource[], Error>;
+
+/**
+ * Resolve a single error by ID.
+ */
+declare function useResolveError(): _tanstack_react_query.UseMutationResult<unknown, Error, string, unknown>;
+/**
+ * Unresolve a previously resolved error.
+ */
+declare function useUnresolveError(): _tanstack_react_query.UseMutationResult<unknown, Error, string, unknown>;
+/**
+ * Resolve all errors in the organization.
+ */
+declare function useResolveAllErrors(): _tanstack_react_query.UseMutationResult<unknown, Error, void, unknown>;
+/**
+ * Resolve all errors for a specific execution.
+ */
+declare function useResolveErrorsByExecution(): _tanstack_react_query.UseMutationResult<unknown, Error, string, unknown>;
+
+declare function useCostTrends(timeRange: TimeRange, granularity?: 'hour' | 'day' | 'week'): _tanstack_react_query.UseQueryResult<CostTrendsResponse, Error>;
+
+declare function useCostByModel(timeRange: TimeRange): _tanstack_react_query.UseQueryResult<CostByModelResponse, Error>;
+
+interface CostBreakdownItem {
+    resourceId: string;
+    resourceType: string;
+    model: string;
+    totalCost: number;
+    executionCount: number;
+}
+declare function useCostBreakdown(timeRange: TimeRange): _tanstack_react_query.UseQueryResult<CostBreakdownItem[], Error>;
+
+declare function useDashboardMetrics(timeRange: TimeRange): _tanstack_react_query.UseQueryResult<unknown, Error>;
+
+interface BusinessImpactMetrics {
+    totalExecutions: number;
+    estimatedTimeSavedMinutes: number;
+    estimatedCostSavings: number;
+    automationROI: number;
+}
+declare function useBusinessImpact(timeRange: TimeRange): _tanstack_react_query.UseQueryResult<BusinessImpactMetrics, Error>;
+
+/**
+ * Query key factory for schedule cache management.
+ * Provides type-safe, hierarchical keys for TanStack Query.
+ * 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"];
+};
+/**
+ * Filters for list schedules query.
+ * Mirrors ListSchedulesQuery from @repo/core but typed for UI consumption.
+ */
+interface ListSchedulesFilters {
+    status?: 'active' | 'paused' | 'completed' | 'cancelled';
+    targetResourceType?: 'agent' | 'workflow';
+    targetResourceId?: string;
+    limit?: number;
+    offset?: number;
+}
+
+interface CreateScheduleInput {
+    name: string;
+    description?: string;
+    target: {
+        resourceType: 'agent' | 'workflow';
+        resourceId: string;
+    };
+    scheduleConfig: TaskScheduleConfig;
+    maxRetries?: number;
+    idempotencyKey?: string;
+    originExecutionId?: string;
+    originResourceType?: 'agent' | 'workflow' | 'scheduler' | 'api';
+    originResourceId?: string;
+}
+interface UpdateScheduleInput {
+    id: string;
+    name?: string;
+    description?: string | null;
+    scheduleConfig?: TaskScheduleConfig;
+    maxRetries?: number;
+}
+/** List response using domain type for CC compatibility. */
+interface ListSchedulesResponse {
+    schedules: TaskSchedule[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/**
+ * List schedules with optional filters.
+ *
+ * @param filters - Optional filters for status, target resource, and pagination
+ * @returns TanStack Query result with schedules array and pagination info
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useListSchedules({ status: 'active', limit: 20 })
+ * ```
+ */
+declare function useListSchedules(filters?: ListSchedulesFilters): _tanstack_react_query.UseQueryResult<ListSchedulesResponse, Error>;
+/**
+ * Get a single schedule by ID.
+ *
+ * @param id - Schedule UUID (undefined to disable query)
+ * @returns TanStack Query result with schedule data
+ *
+ * @example
+ * ```tsx
+ * const { data: schedule, isLoading } = useGetSchedule(scheduleId)
+ * ```
+ */
+declare function useGetSchedule(id: string | undefined): _tanstack_react_query.UseQueryResult<TaskSchedule, Error>;
+/**
+ * Get execution history for a schedule.
+ *
+ * @param scheduleId - Schedule UUID (undefined to disable query)
+ * @param options - Pagination options (limit, offset)
+ * @returns TanStack Query result with execution history and pagination info
+ *
+ * @example
+ * ```tsx
+ * const { data } = useGetExecutionHistory(scheduleId, { limit: 10 })
+ * ```
+ */
+declare function useGetExecutionHistory(scheduleId: string | undefined, options?: {
+    limit?: number;
+    offset?: number;
+}): _tanstack_react_query.UseQueryResult<{
+    executions: {
+        id: string;
+        createdAt: string;
+        status: "completed" | "failed" | "running" | "cancelled";
+        step: number | null;
+        itemLabel: string | null;
+        duration: number | null;
+        error: string | null;
+    }[];
+    total: number;
+    limit: number;
+    offset: number;
+}, Error>;
+/**
+ * Create a new schedule.
+ *
+ * @returns TanStack Mutation for creating schedules
+ *
+ * @example
+ * ```tsx
+ * const createSchedule = useCreateSchedule()
+ *
+ * createSchedule.mutate({
+ *   name: 'Daily Report',
+ *   target: { resourceType: 'workflow', resourceId: 'wf-123' },
+ *   scheduleConfig: { type: 'recurring', cron: '0 9 * * *', timezone: 'UTC', payload: {} }
+ * })
+ * ```
+ */
+declare function useCreateSchedule(): _tanstack_react_query.UseMutationResult<TaskSchedule, Error, CreateScheduleInput, unknown>;
+/**
+ * Update schedule fields (name, description, scheduleConfig, maxRetries).
+ * Only active or paused schedules can be updated.
+ *
+ * @returns TanStack Mutation for updating schedules
+ *
+ * @example
+ * ```tsx
+ * const updateSchedule = useUpdateSchedule()
+ *
+ * updateSchedule.mutate({ id: 'schedule-123', name: 'Updated Name' })
+ * ```
+ */
+declare function useUpdateSchedule(): _tanstack_react_query.UseMutationResult<TaskSchedule, Error, UpdateScheduleInput, unknown>;
+/**
+ * Update anchor datetime for relative schedules.
+ * Only applicable to schedules with type: 'relative'.
+ *
+ * @returns TanStack Mutation for updating schedule anchor
+ *
+ * @example
+ * ```tsx
+ * const updateAnchor = useUpdateAnchor()
+ *
+ * updateAnchor.mutate({ id: 'schedule-123', anchorAt: '2026-02-01T09:00:00Z' })
+ * ```
+ */
+declare function useUpdateAnchor(): _tanstack_react_query.UseMutationResult<TaskSchedule, Error, {
+    id: string;
+    anchorAt: string;
+}, unknown>;
+/**
+ * Pause a schedule.
+ * Paused schedules will not execute until resumed.
+ *
+ * @returns TanStack Mutation for pausing schedules
+ *
+ * @example
+ * ```tsx
+ * const pauseSchedule = usePauseSchedule()
+ * pauseSchedule.mutate('schedule-123')
+ * ```
+ */
+declare function usePauseSchedule(): _tanstack_react_query.UseMutationResult<TaskSchedule, Error, string, unknown>;
+/**
+ * Resume a paused schedule.
+ *
+ * @returns TanStack Mutation for resuming schedules
+ *
+ * @example
+ * ```tsx
+ * const resumeSchedule = useResumeSchedule()
+ * resumeSchedule.mutate('schedule-123')
+ * ```
+ */
+declare function useResumeSchedule(): _tanstack_react_query.UseMutationResult<TaskSchedule, Error, string, unknown>;
+/**
+ * Cancel a schedule permanently (soft delete).
+ * Sets status to 'cancelled' -- schedule remains in DB for history.
+ * Cancelled schedules cannot be resumed.
+ *
+ * @returns TanStack Mutation for cancelling schedules
+ *
+ * @example
+ * ```tsx
+ * const cancelSchedule = useCancelSchedule()
+ * cancelSchedule.mutate('schedule-123')
+ * ```
+ */
+declare function useCancelSchedule(): _tanstack_react_query.UseMutationResult<TaskSchedule, Error, string, unknown>;
+/**
+ * Delete a schedule permanently (hard delete).
+ * Removes schedule from database entirely.
+ *
+ * @returns TanStack Mutation for deleting schedules
+ *
+ * @example
+ * ```tsx
+ * const deleteSchedule = useDeleteSchedule()
+ * deleteSchedule.mutate('schedule-123')
+ * ```
+ */
+declare function useDeleteSchedule(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+
+interface SessionListItem {
+    sessionId: string;
+    resourceId: string;
+    turnCount: number;
+    isEnded: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface CreateSessionResponse {
+    sessionId: string;
+    resourceId: string;
+    turnCount: number;
+    createdAt: string;
+}
+/**
+ * Response type from the /api/dev/execution-engine/resources endpoint
+ */
+interface ResourcesResponse {
+    workflows: ResourceDefinition[];
+    agents: ResourceDefinition[];
+    pipelines: ResourceDefinition[];
+}
+/**
+ * Operations Service for fetching Execution Engine resources
+ */
+declare class OperationsService {
+    private apiRequest;
+    constructor(apiRequest: <T>(endpoint: string, options?: RequestInit) => Promise<T>);
+    /**
+     * Fetch all available Execution Engine resources
+     * Uses the unified /list-resources endpoint
+     */
+    getResources(): Promise<ResourcesResponse>;
+    /**
+     * Get detailed workflow information
+     * Optional: For future detailed views
+     */
+    getWorkflowDetails(): Promise<ResourceDefinition[]>;
+    /**
+     * Get detailed agent information
+     * Optional: For future detailed views
+     */
+    getAgentDetails(): Promise<ResourceDefinition[]>;
+    /**
+     * Get detailed pipeline information
+     * Optional: For future detailed views
+     */
+    getPipelineDetails(): Promise<ResourceDefinition[]>;
+    /**
+     * Get resource definition (workflow steps, agent actions, pipeline stages, etc.)
+     */
+    getResourceDefinition(resourceId: string): Promise<AIResourceDefinition>;
+    /**
+     * List sessions with optional filtering
+     */
+    listSessions(params?: {
+        resourceId?: string;
+    }): Promise<SessionListItem[]>;
+    /**
+     * Get session details by ID
+     */
+    getSession(sessionId: string): Promise<SessionDTO>;
+    /**
+     * Create a new session for an agent
+     */
+    createSession(resourceId: string): Promise<CreateSessionResponse>;
+    /**
+     * Archive a session
+     */
+    archiveSession(sessionId: string): Promise<void>;
+}
+
+/**
+ * Shared hook for pagination state management.
+ * Encapsulates page state, offset calculation, and reset-on-filter-change.
+ *
+ * @param pageSize - Number of items per page
+ * @param resetDeps - When any dependency changes, page resets to 1. Omit to disable auto-reset.
+ * @param total - When provided, automatically retreats to the last valid page if the current page becomes empty (e.g., after bulk deletion).
+ */
+declare function usePaginationState(pageSize: number, resetDeps?: unknown[], total?: number): {
+    page: number;
+    setPage: react.Dispatch<react.SetStateAction<number>>;
+    offset: number;
+    totalPages: (total: number) => number;
+};
+
+/**
+ * Generic table row selection hook.
+ * Tracks selected IDs, provides toggle/toggleAll/clear, and computes selection state.
+ *
+ * @param items - Current page items (must have `id: string`)
+ * @param allItems - All items across all pages (for "select all" to work across pages). Defaults to `items`.
+ */
+declare function useTableSelection<T extends {
+    id: string;
+}>(items: T[], allItems?: T[]): {
+    selectedIds: Set<string>;
+    toggle: (id: string) => void;
+    togglePage: () => void;
+    clear: () => void;
+    isPageAllSelected: boolean;
+    isPagePartiallySelected: boolean;
+    selectedCount: number;
+    isSelected: (id: string) => boolean;
+};
+
+type SortDirection = 'asc' | 'desc';
+interface SortState {
+    column: string;
+    direction: SortDirection;
+}
+/**
+ * Generic table sorting hook.
+ * Manages sort column + direction, and provides a sort utility for client-side data.
+ */
+declare function useTableSort(defaultColumn: string, defaultDirection?: SortDirection): {
+    sort: SortState;
+    toggleSort: (column: string) => void;
+};
+/**
+ * Sort an array of items by a column using accessor functions.
+ *
+ * @param data - Array to sort (not mutated)
+ * @param sort - Current sort state
+ * @param accessors - Map of column name → accessor function
+ */
+declare function sortData<T>(data: T[], sort: SortState, accessors: Record<string, (item: T) => string | number | boolean | null | undefined>): T[];
+/**
+ * Hook that combines useTableSort with memoized sortData.
+ * Returns the sort state, toggle function, and a memoized sort function.
+ */
+declare function useSortedData<T>(data: T[], defaultColumn: string, accessors: Record<string, (item: T) => string | number | boolean | null | undefined>, defaultDirection?: SortDirection): {
+    sorted: T[];
+    sort: SortState;
+    toggleSort: (column: string) => void;
+};
+
+interface InitializationError {
+    layer: 'auth' | 'profile' | 'organization';
+    message: string;
+    originalError?: Error;
+}
+interface AppInitializationState {
+    userReady: boolean;
+    organizationReady: boolean;
+    allReady: boolean;
+    isInitializing: boolean;
+    error: InitializationError | null;
+    retry: () => void;
+    profile: SupabaseUserProfile | null;
+}
+
+/**
+ * The value exposed by OrganizationProvider to all consumers.
+ */
+interface OrganizationContextValue {
+    /** WorkOS organization ID of the currently selected organization. */
+    currentWorkOSOrganizationId: string | null;
+    /** Supabase (UUID) organization ID of the currently selected organization. */
+    currentSupabaseOrganizationId: string | null;
+    /** Full membership record for the currently selected organization. */
+    currentMembership: MembershipWithDetails | null;
+    /** All memberships for the authenticated user. */
+    memberships: MembershipWithDetails[];
+    /** True while the initial membership list is being fetched. */
+    isInitializing: boolean;
+    /** True while a subsequent org switch / refresh is in flight. */
+    isOrgRefreshing: boolean;
+    /** Error message if the membership fetch or org switch failed. */
+    error: string | null;
+    /**
+     * Switch the active organization.
+     *
+     * Persists the selection to `last_visited_org` on the user profile and
+     * invalidates all org-scoped TanStack Query cache entries.
+     *
+     * @param workosOrgId - WorkOS organization ID to switch to.
+     */
+    switchOrganization: (workosOrgId: string) => void;
+    /**
+     * Re-fetch memberships and retry org selection after an error.
+     */
+    retry: () => Promise<void>;
+}
+
+type RestrictionSource = 'org' | 'membership' | null;
+interface FeatureAccessResult {
+    allowed: boolean;
+    restrictedBy: RestrictionSource;
+}
+/**
+ * Factory that creates a `useFeatureAccess` hook scoped to the consumer's
+ * feature configuration.
+ *
+ * @param useInitialization - Initialization hook providing `profile` and `organizationReady`
+ * @param useOrganization   - Organization hook providing `currentMembership`
+ * @param optInFeatures     - Feature keys that are disabled by default (must be explicitly enabled)
+ *
+ * @example
+ * ```typescript
+ * // In your app's feature-access module
+ * import { createUseFeatureAccess } from '@repo/ui/hooks'
+ * import { useInitialization } from '@repo/ui/initialization'
+ * import { useOrganization } from '@repo/ui/organization'
+ *
+ * export const useFeatureAccess = createUseFeatureAccess({
+ *   useInitialization,
+ *   useOrganization,
+ *   optInFeatures: ['acquisition', 'calibration'],
+ * })
+ * ```
+ */
+declare function createUseFeatureAccess({ useInitialization, useOrganization, optInFeatures }: {
+    useInitialization: () => Pick<AppInitializationState, 'profile' | 'organizationReady'>;
+    useOrganization: () => Pick<OrganizationContextValue, 'currentMembership'>;
+    optInFeatures?: string[];
+}): () => {
+    orgConfig: OrgFeatureConfig | undefined;
+    membershipConfig: OrgFeatureConfig | undefined;
+    userConfig: UserConfig | undefined;
+    hasFeature: (featureKey: string) => boolean;
+    checkFeature: (featureKey: string) => FeatureAccessResult;
+    isReady: boolean;
+};
+
+interface EventSourceMessage {
+    id: string;
+    event: string;
+    data: string;
+    retry?: number;
+}
+
+interface FetchEventSourceWithTokenRefreshOptions {
+    url: string;
+    getToken: () => Promise<string | undefined>;
+    headers?: Record<string, string>;
+    signal: AbortSignal;
+    /** Delay in ms before reconnecting after token refresh. Defaults to 2000. */
+    tokenRefreshDelayMs?: number;
+    onopen?: (response: Response) => void | Promise<void>;
+    onmessage?: (event: EventSourceMessage) => void;
+    onerror?: (error: unknown) => void;
+    onclose?: () => void;
+}
+
+interface SSEConnectionManagerOptions {
+    /** Grace period in ms before closing idle connections. Defaults to 5000. */
+    closeGracePeriodMs?: number;
+}
+/**
+ * SSE Connection Manager
+ *
+ * Ensures only ONE SSE connection exists per endpoint, preventing duplicate
+ * connections when components re-render or remount.
+ *
+ * Benefits:
+ * - Prevents resource waste from duplicate connections
+ * - Eliminates race conditions from overlapping connections
+ * - Automatically manages connection lifecycle
+ * - Shares single connection across multiple subscribers
+ */
+declare class SSEConnectionManager {
+    private connections;
+    private closeGracePeriodMs;
+    constructor(options?: SSEConnectionManagerOptions);
+    /**
+     * Subscribe to an SSE endpoint
+     *
+     * If a connection already exists for this endpoint, reuses it.
+     * Otherwise, creates a new connection.
+     *
+     * @param key - Unique identifier for the connection (e.g., 'notifications', 'resource-executive-agent')
+     * @param subscriberId - Unique identifier for this subscriber (usually component instance)
+     * @param options - SSE connection options
+     * @returns Unsubscribe function to call when component unmounts
+     */
+    subscribe(key: string, subscriberId: string, options: Omit<FetchEventSourceWithTokenRefreshOptions, 'signal'>): () => void;
+    /**
+     * Unsubscribe from an SSE endpoint
+     *
+     * If this is the last subscriber, closes the connection after grace period.
+     */
+    private unsubscribe;
+    /**
+     * Force close a connection and all its subscribers
+     */
+    closeConnection(key: string): void;
+    /**
+     * Get current connection status
+     */
+    getConnectionInfo(): Map<string, {
+        url: string;
+        subscribers: number;
+    }>;
+}
+
+interface UseSSEConnectionOptions {
+    manager: SSEConnectionManager;
+    /** Shared connection key — all subscribers with the same key share ONE connection. */
+    connectionKey: string;
+    url: string;
+    /** When false the subscription is skipped. Defaults to true. */
+    enabled?: boolean;
+    headers?: Record<string, string>;
+    /** Called for each non-empty SSE message with the raw `event.data` string. */
+    onmessage: (data: string) => void;
+    /**
+     * Called when the connection opens. Return a non-empty string to set it as
+     * the error state (e.g. `response.status === 403 ? 'Access denied' : undefined`).
+     */
+    onopen?: (response: Response) => string | void;
+    onerror?: (err: Error) => void;
+    onclose?: () => void;
+}
+/**
+ * Generic SSE subscription hook.
+ *
+ * Handles token refresh, connection state, subscriber ID generation, and
+ * subscribe/cleanup lifecycle via the shared SSEConnectionManager.
+ *
+ * Domain-specific event parsing (e.g. `ExecutionSSEEvent`) stays in the
+ * caller's `onmessage` handler.
+ *
+ * @example
+ * ```typescript
+ * const { connected, error } = useSSEConnection({
+ *   manager: sseConnectionManager,
+ *   connectionKey: `resource-${resourceId}`,
+ *   url: `${API_URL}/api/execution-engine/sse/${resourceId}`,
+ *   enabled: isOrganizationReady,
+ *   headers: { [HTTP_HEADERS.WORKOS_ORGANIZATION_ID]: orgId },
+ *   onmessage: (data) => {
+ *     const event = JSON.parse(data)
+ *     // handle domain-specific event
+ *   },
+ * })
+ * ```
+ */
+declare function useSSEConnection({ manager, connectionKey, url, enabled, headers, onmessage, onopen, onerror, onclose }: UseSSEConnectionOptions): {
+    connected: boolean;
+    error: string | null;
+};
+
+export { OperationsService, createUseFeatureAccess, executionsKeys, observabilityKeys, scheduleKeys, sortData, useActivities, useActivityTrend, useBatchDelete, useBulkDeleteExecutions, useBusinessImpact, useCancelExecution, useCancelSchedule, useCommandQueue, useCommandQueueTotals, useCostBreakdown, useCostByModel, useCostSummary, useCostTrends, useCreateSchedule, useDashboardMetrics, useDeleteExecution, useDeleteSchedule, useDeleteTask, useErrorAnalysis, useErrorDetail, useErrorDetails, useErrorDistribution, useErrorNotification, useErrorTrends, useExecuteAsync, useExecution, useExecutionHealth, useExecutionLogs, useExecutions, useGetExecutionHistory, useGetSchedule, useListSchedules, useMarkAllAsRead, useMarkAsRead, useNotificationCount, useNotifications, usePaginationState, usePatchTask, usePauseSchedule, useResolveAllErrors, useResolveError, useResolveErrorsByExecution, useResourceDefinition, useResources, useResumeSchedule, useRetryExecution, useSSEConnection, useSortedData, useSubmitAction, useSuccessNotification, useTableSelection, useTableSort, useTopFailingResources, useUnresolveError, useUpdateAnchor, useUpdateSchedule, useWarningNotification };
+export type { ActivityTrendResponse, BulkDeleteExecutionsParams, BulkDeleteExecutionsResult, BusinessImpactMetrics, CancelExecutionParams, CancelExecutionResult, CostBreakdownItem, CreateScheduleInput, CreateSessionResponse, DeleteExecutionParams, ErrorDistributionItem, ErrorDistributionParams, ErrorFilters, ErrorTrendsParams, ExecuteAsyncParams, ExecuteAsyncResult, ExecutionErrorDetails, ExecutionHistoryItem, ExecutionHistoryResponse, ExecutionLogsPageResponse, FailingResource, ListActivitiesResponse, ListSchedulesFilters, ListSchedulesResponse, ResourcesResponse, RetryExecutionParams, SessionListItem, SortDirection, SortState, SubmitActionRequest, SubmitActionResponse, TaskSchedule, TopFailingResourcesParams, UpdateScheduleInput, UseActivitiesParams, UseActivityTrendParams, UseExecutionHealthParams, UseExecutionLogsParams, UseSSEConnectionOptions };