@elevasis/ui 1.3.5 → 1.3.7

package/dist/types/index.d.ts

@@ -0,0 +1,3800 @@
+import { z } from 'zod';
+
+/**
+ * Workflow-specific logging types and utilities
+ */
+
+interface WorkflowExecutionContext$1 {
+    type: 'workflow';
+    contextType: 'workflow-execution';
+    executionId: string;
+    workflowId: string;
+    workflowName?: string;
+    organizationId: string;
+    executionPath?: string[];
+}
+interface WorkflowFailureContext$1 {
+    type: 'workflow';
+    contextType: 'workflow-failure';
+    executionId: string;
+    workflowId: string;
+    error: string;
+}
+interface StepStartedContext$1 {
+    type: 'workflow';
+    contextType: 'step-started';
+    stepId: string;
+    stepStatus: 'started';
+    input: unknown;
+    startTime: number;
+}
+interface StepCompletedContext$1 {
+    type: 'workflow';
+    contextType: 'step-completed';
+    stepId: string;
+    stepStatus: 'completed';
+    output: unknown;
+    duration: number;
+    isTerminal: boolean;
+    startTime: number;
+    endTime: number;
+}
+interface StepFailedContext$1 {
+    type: 'workflow';
+    contextType: 'step-failed';
+    stepId: string;
+    stepStatus: 'failed';
+    error: string;
+    duration: number;
+    startTime: number;
+    endTime: number;
+}
+interface ConditionalRouteContext$1 {
+    type: 'workflow';
+    contextType: 'conditional-route';
+    stepId: string;
+    target: string;
+    error?: string;
+}
+interface ExecutionPathContext$1 {
+    type: 'workflow';
+    contextType: 'execution-path';
+    executionPath: string[];
+}
+type WorkflowLogContext$1 = WorkflowExecutionContext$1 | WorkflowFailureContext$1 | StepStartedContext$1 | StepCompletedContext$1 | StepFailedContext$1 | ConditionalRouteContext$1 | ExecutionPathContext$1;
+
+/**
+ * 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)
+ */
+
+/**
+ * Agent lifecycle stages
+ * Universal checkpoints that apply to all agent executions
+ */
+type AgentLifecycle$1 = 'initialization' | 'iteration' | 'completion';
+/**
+ * Iteration event types
+ * Activities that occur during agent iterations
+ */
+type IterationEventType$1 = 'reasoning' | 'action' | 'tool-call';
+/**
+ * Base fields shared by all lifecycle events
+ */
+interface AgentLifecycleEventBase$1 {
+    type: 'agent';
+    agentId: string;
+    lifecycle: AgentLifecycle$1;
+    sessionId?: string;
+}
+/**
+ * Lifecycle started event - emitted when a phase begins
+ * REQUIRED: startTime (phase has started, no end yet)
+ */
+interface AgentLifecycleStartedEvent$1 extends AgentLifecycleEventBase$1 {
+    stage: 'started';
+    startTime: number;
+    iteration?: number;
+}
+/**
+ * Lifecycle completed event - emitted when a phase succeeds
+ * REQUIRED: startTime, endTime, duration (phase has finished successfully)
+ */
+interface AgentLifecycleCompletedEvent$1 extends AgentLifecycleEventBase$1 {
+    stage: 'completed';
+    startTime: number;
+    endTime: number;
+    duration: number;
+    iteration?: number;
+    attempts?: number;
+    memorySize?: {
+        sessionMemoryKeys: number;
+        historyEntries: number;
+    };
+}
+/**
+ * Lifecycle failed event - emitted when a phase fails
+ * REQUIRED: startTime, endTime, duration, error (phase has finished with error)
+ */
+interface AgentLifecycleFailedEvent$1 extends AgentLifecycleEventBase$1 {
+    stage: 'failed';
+    startTime: number;
+    endTime: number;
+    duration: number;
+    error: string;
+    iteration?: number;
+}
+/**
+ * Union type for all lifecycle events
+ * Discriminated by 'stage' field for type narrowing
+ */
+type AgentLifecycleEvent$1 = AgentLifecycleStartedEvent$1 | AgentLifecycleCompletedEvent$1 | AgentLifecycleFailedEvent$1;
+/**
+ * Placeholder data for MVP
+ * Will be typed per actionType in future
+ */
+interface ActionPlaceholderData$1 {
+    message: string;
+}
+/**
+ * Iteration event - captures activities during agent iterations
+ * Consolidates reasoning (LLM thought process) and actions (tool use, memory ops, etc.)
+ */
+interface AgentIterationEvent$1 {
+    type: 'agent';
+    agentId: string;
+    lifecycle: 'iteration';
+    eventType: IterationEventType$1;
+    iteration: number;
+    sessionId?: string;
+    startTime: number;
+    endTime: number;
+    duration: number;
+    output?: string;
+    actionType?: string;
+    data?: ActionPlaceholderData$1;
+}
+/**
+ * Tool call event - captures individual tool executions during iterations
+ * Provides granular timing for each tool invocation
+ */
+interface AgentToolCallEvent$1 {
+    type: 'agent';
+    agentId: string;
+    lifecycle: 'iteration';
+    eventType: 'tool-call';
+    iteration: number;
+    sessionId?: string;
+    toolName: string;
+    startTime: number;
+    endTime: number;
+    duration: number;
+    success: boolean;
+    error?: string;
+    input?: Record<string, unknown>;
+    output?: unknown;
+}
+/**
+ * Union type for all agent log contexts
+ * 3 event types total (lifecycle, iteration, tool-call)
+ */
+type AgentLogContext$1 = AgentLifecycleEvent$1 | AgentIterationEvent$1 | AgentToolCallEvent$1;
+
+/**
+ * Base execution logger for Execution Engine
+ */
+type ExecutionLogLevel$1 = 'debug' | 'info' | 'warn' | 'error';
+
+type LogContext$1 = WorkflowLogContext$1 | AgentLogContext$1;
+interface ExecutionLogMessage$1 {
+    level: ExecutionLogLevel$1;
+    message: string;
+    timestamp: number;
+    context?: LogContext$1;
+}
+
+/**
+ * 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$1 = 'text' | 'textarea' | 'number' | 'select' | 'checkbox' | 'radio' | 'richtext';
+
+/**
+ * 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$1;
+    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'>;
+
+/**
+ * Origin resource type - where an execution/task originated from.
+ * Used for audit trails and tracking execution lineage.
+ */
+type OriginResourceType$1 = 'agent' | 'workflow' | 'scheduler' | 'api';
+
+/**
+ * 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$1;
+    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;
+}
+
+type MessageType = MessageEvent['type'];
+/**
+ * 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;
+}
+interface ChatMessage {
+    id: string;
+    role: 'user' | 'assistant';
+    messageType: MessageType;
+    text: string;
+    metadata?: MessageEvent;
+    turnNumber: number;
+    messageIndex?: number;
+    createdAt: Date;
+}
+/** Token usage data sent with turn:complete WebSocket events */
+interface SessionTokenUsage {
+    /** Tokens consumed by this turn's input */
+    turnInputTokens: number;
+    /** Tokens generated by this turn's output */
+    turnOutputTokens: number;
+    /** Total tokens for this turn (turnInputTokens + turnOutputTokens) */
+    turnTotalTokens: number;
+    /** Cumulative input tokens across all turns in this session */
+    cumulativeInputTokens: number;
+    /** Cumulative output tokens across all turns in this session */
+    cumulativeOutputTokens: number;
+    /** The model's context window size for this session (e.g., 200K) */
+    contextWindowSize: number;
+}
+
+/**
+ * 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;
+}
+
+/**
+ * Base Execution Engine type definitions
+ * Core types shared across all Execution Engine resources
+ */
+
+/**
+ * Unified message event type - covers all message types in sessions
+ * Replaces separate SessionTurnMessages and AgentActivityEvent mechanisms
+ */
+/**
+ * Structured action metadata attached to assistant messages.
+ * Frontend reads this instead of parsing text prefixes.
+ */
+type AssistantAction = {
+    kind: 'navigate';
+    path: string;
+    reason: string;
+} | {
+    kind: 'update_filters';
+    timeRange: string | null;
+    statusFilter: string | null;
+    searchQuery: string | null;
+};
+type MessageEvent = {
+    type: 'user_message';
+    text: string;
+} | {
+    type: 'assistant_message';
+    text: string;
+    _action?: AssistantAction;
+} | {
+    type: 'agent:started';
+} | {
+    type: 'agent:completed';
+} | {
+    type: 'agent:error';
+    error: string;
+} | {
+    type: 'agent:reasoning';
+    iteration: number;
+    reasoning: string;
+} | {
+    type: 'agent:tool_call';
+    toolName: string;
+    args: Record<string, unknown>;
+} | {
+    type: 'agent:tool_result';
+    toolName: string;
+    success: boolean;
+    result?: unknown;
+    error?: string;
+};
+/**
+ * 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 = 'dev' | 'prod';
+/**
+ * All resource types in the platform
+ * Used as the discriminator field in ResourceDefinition
+ */
+type ResourceType = '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;
+    /** Environment/deployment status */
+    status: ResourceStatus;
+    /** 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';
+interface APIExecutionSummary {
+    id: string;
+    status: ExecutionStatus$1;
+    startTime: number;
+    endTime?: number;
+    resourceStatus?: ResourceStatus;
+}
+interface APIExecutionDetail extends APIExecutionSummary {
+    executionLogs: ExecutionLogMessage$1[];
+    input?: unknown;
+    result?: unknown;
+    error?: string;
+    resourceStatus: ResourceStatus;
+    apiVersion?: string | null;
+    resourceVersion?: string | null;
+    sdkVersion?: string | null;
+}
+interface APIExecutionListResponse {
+    executions: APIExecutionSummary[];
+}
+
+/**
+ * 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
+}
+
+/**
+ * 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'       // TextInput
+  | 'textarea'   // Textarea
+  | 'number'     // NumberInput
+  | 'select'     // Select dropdown
+  | 'checkbox'   // Checkbox
+  | 'radio'      // Radio group
+  | 'richtext'   // Rich text editor (TipTap)
+
+/**
+ * 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[]
+}
+
+/**
+ * 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'
+
+// ============================================================================
+// API Request/Response Types (Dashboard Observability)
+// ============================================================================
+
+/**
+ * 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 {
+  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
+  /** 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 Tracking Types
+// ============================================================================
+
+/**
+ * Error record for list view (ErrorBreakdownTable)
+ */
+interface ErrorRecord {
+  id: string // execution_errors.id
+  timestamp: string // occurred_at
+  errorType: string // error_type
+  message: string // error_message
+  executionId: string // execution_id
+  resourceId: string // execution_logs.resource_id (via JOIN)
+  resourceName: string // execution_logs.resource_id (TODO: resolve via registry)
+  severity: 'critical' | 'warning' | 'info'
+  category: ExecutionErrorCategory // error_category (moved from metadata to dedicated column)
+  resolved: boolean // resolved flag (human acknowledgment, does not affect execution status)
+  resolvedAt: string | null // timestamp when resolved
+  resolvedBy: string | null // user ID who resolved
+}
+
+/**
+ * Full error detail for modal view (ErrorDetailsModal)
+ */
+interface ErrorDetailFull extends ErrorRecord {
+  stackTrace?: string // error_stack_trace
+  retryAttempt?: number // metadata.retryAttempt
+  stepName?: string // metadata.stepName
+  stepSequence?: number // metadata.stepSequence
+  errorContext?: Record<string, unknown> // metadata.errorContext
+  executionContext?: Record<string, unknown> // metadata.executionContext
+}
+
+/**
+ * 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 // Time bucket (ISO timestamp)
+  errorCount: number // Total errors in bucket
+  criticalCount: number // Critical errors in bucket
+  warningCount: number // Warning errors in bucket
+  infoCount: number // Info errors in bucket
+}
+
+// ============================================================================
+// Cost Analytics Types (Time-Series)
+// ============================================================================
+
+/**
+ * Cost trend data point for time-series charts
+ * Represents a single time bucket (hour or day)
+ */
+interface CostTrendDataPoint {
+  time: string // ISO timestamp (bucket start)
+  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
+}
+
+/**
+ * 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
+
+  // NEW: Flexible action system
+  actions: ActionConfig[]
+  context: unknown
+  selectedAction?: string
+  actionPayload?: unknown
+
+  // Task metadata
+  description?: string
+  priority: number
+
+  /** Optional checkpoint identifier for grouping related human approval tasks */
+  humanCheckpoint?: string
+
+  // Status (updated to include 'completed')
+  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
+}
+
+/**
+ * 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
+}
+
+// Execution status type shared between API and UI
+type ExecutionStatus = 'pending' | 'running' | 'completed' | 'failed' | 'warning'
+
+/**
+ * Execution Runner Types
+ *
+ * Shared types for the Execution Runner UI feature.
+ * Used by both API (apps/api) and frontend (apps/command-center).
+ */
+
+
+
+// ============================================================================
+// EXECUTION METRICS
+// ============================================================================
+
+interface ExecutionMetrics {
+  tokenCount?: number
+  stepCount?: number
+  toolCallCount?: number
+}
+
+// ============================================================================
+// EXECUTION HISTORY TYPES
+// ============================================================================
+
+interface ExecutionSummary {
+  id: string
+  resourceId: string
+  resourceName: string
+  status: ExecutionStatus
+  startedAt: string
+  completedAt?: string
+  durationMs?: number
+  metrics?: ExecutionMetrics
+  input?: unknown
+  output?: unknown
+  error?: { message: string }
+}
+
+/**
+ * Execution history item.
+ * Represents a single execution triggered by a schedule.
+ */
+declare const ExecutionHistoryItemSchema = z.object({
+  id: z.string().uuid(),
+  createdAt: z.string().datetime(),
+  status: z.enum(['running', 'completed', 'failed', 'cancelled']),
+  step: z.number().int().nullable(),
+  itemLabel: z.string().nullable(),
+  duration: z.number().nullable(), // milliseconds
+  error: z.string().nullable()
+})
+
+/**
+ * Execution history response.
+ * Returned by GET /schedules/:id/executions with pagination.
+ */
+declare const ExecutionHistoryResponseSchema = z.object({
+  executions: z.array(ExecutionHistoryItemSchema),
+  total: z.number().int(),
+  limit: z.number().int(),
+  offset: z.number().int()
+})
+type ExecutionHistoryItem = z.infer<typeof ExecutionHistoryItemSchema>
+type ExecutionHistoryResponse = z.infer<typeof ExecutionHistoryResponseSchema>
+
+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
+}
+
+/**
+ * Webhook Endpoint Domain Types
+ *
+ * Browser-safe domain types for generic inbound webhook endpoints.
+ * These are camelCase representations of the `webhook_endpoints` DB table.
+ *
+ * Transform from snake_case DB rows happens in the API service layer,
+ * not here (per core-package.md conventions).
+ */
+
+/**
+ * Lifecycle status of a webhook endpoint.
+ * - `active`: Endpoint accepts inbound requests and triggers the target workflow
+ * - `paused`: Endpoint exists but rejects inbound requests with 404
+ */
+type WebhookEndpointStatus = 'active' | 'paused'
+
+/**
+ * Generic inbound webhook endpoint domain type.
+ *
+ * Each endpoint gets a unique opaque URL (`/api/webhooks/inbound/:key`)
+ * that maps to a target workflow resource within an organization.
+ */
+interface WebhookEndpoint {
+  /** UUID primary key */
+  id: string
+  /** Organization this endpoint belongs to */
+  organizationId: string
+  /**
+   * Unique opaque key used in the inbound URL.
+   * Format: `wh_` + 32 crypto-random hex chars (128 bits of entropy).
+   * This key IS the credential — it must be kept secret.
+   */
+  key: string
+  /** User-facing label (e.g., "Zapier → Lead Intake") */
+  name: string
+  /** Optional description for the endpoint */
+  description: string | null
+  /** Target workflow resourceId to invoke on inbound request, or null if not yet assigned */
+  resourceId: string | null
+  /** Whether the endpoint is accepting requests */
+  status: WebhookEndpointStatus
+  /** Timestamp of the most recent successful inbound request, or null */
+  lastTriggeredAt: string | null
+  /** Running total of inbound requests received */
+  requestCount: number
+  /** ISO 8601 creation timestamp */
+  createdAt: string
+  /** ISO 8601 last-updated timestamp */
+  updatedAt: string
+}
+
+/**
+ * POST /api/webhook-endpoints - Create a new webhook endpoint
+ *
+ * The `key` and `id` are generated server-side and not accepted in the request.
+ */
+declare const CreateWebhookEndpointRequestSchema = z
+  .object({
+    /** User-facing label for the endpoint */
+    name: NonEmptyStringSchema,
+    /** Target workflow resourceId to invoke on inbound requests (can be set later) */
+    resourceId: NonEmptyStringSchema.optional(),
+    /** Optional description */
+    description: z.string().optional()
+  })
+  .strict()
+
+type CreateWebhookEndpointRequest = z.infer<typeof CreateWebhookEndpointRequestSchema>
+
+/**
+ * PATCH /api/webhook-endpoints/:id - Update an existing webhook endpoint
+ *
+ * At least one field must be provided.
+ */
+declare const UpdateWebhookEndpointRequestSchema = z
+  .object({
+    name: NonEmptyStringSchema.optional(),
+    description: z.string().optional(),
+    resourceId: NonEmptyStringSchema.optional(),
+    status: WebhookEndpointStatusSchema.optional()
+  })
+  .strict()
+  .refine(
+    (data) =>
+      data.name !== undefined ||
+      data.description !== undefined ||
+      data.resourceId !== undefined ||
+      data.status !== undefined,
+    { message: 'At least one field (name, description, resourceId, or status) must be provided' }
+  )
+
+type UpdateWebhookEndpointRequest = z.infer<typeof UpdateWebhookEndpointRequestSchema>
+
+export type { AIResourceDefinition, APIExecutionDetail, APIExecutionListResponse, Activity, ActivityType, ChatMessage, CheckpointListResponse, CostByModelResponse, CostSummaryResponse, CostTrendsResponse, CreateWebhookEndpointRequest, DashboardMetrics, ErrorAnalysisMetrics, ErrorDetailFull, ErrorDetailResponse, ErrorTrend, ExecutionHistoryItem, ExecutionHistoryResponse, ExecutionLogMessage, ExecutionStatus$1 as ExecutionStatus, ExecutionSummary, MembershipFeatureConfig, MembershipWithDetails, MessageEvent, NotificationDTO, OrgFeatureConfig, PatchTaskParams, ResourceDefinition, ResourceStatus, ResourceType, SessionDTO, SessionTokenUsage, SupabaseUserProfile, Task, TaskSchedule, TaskScheduleConfig, TaskStatus, TimeRange, UpdateWebhookEndpointRequest, UserConfig, WebhookEndpoint };