@elevasis/ui 1.3.4 → 1.3.6

package/dist/hooks/published.d.ts

@@ -1,20 +1,4530 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+import * as react from 'react';
+import { z } from 'zod';
+
 /**
- * Published hooks barrel for @elevasis/ui
- *
- * This file is the entry point for the published `./hooks` export in @elevasis/ui.
- * It re-exports only headless hooks (no Mantine dependency).
- *
- * Internal-only modules (command-queue, etc.) are excluded.
- * See packages/ui/package.json publishConfig for the full published surface.
- */
-export * from './executions';
-export * from './scheduling';
-export * from './monitoring';
-export * from './observability';
-export * from './notifications';
-export * from './services';
-export * from './table';
-export * from './feature-access';
-export * from './sse';
-export * from './sessions';
-//# sourceMappingURL=published.d.ts.map
+ * Query key factory for executions TanStack Query hooks.
+ * Uses organization UUID (not name) for cache isolation.
+ */
+declare const executionsKeys: {
+    all: readonly ["executions"];
+    resources: (orgId: string | null) => readonly ["executions", "resources", string | null];
+    resourceDefinition: (orgId: string | null, resourceId: string) => readonly ["executions", "definition", string | null, string];
+    executions: (orgId: string | null, resourceId: string) => readonly ["executions", "list", string | null, string];
+    execution: (orgId: string | null, resourceId: string, executionId: string) => readonly ["executions", "execution", string | null, string, string];
+};
+
+/**
+ * Workflow-specific logging types and utilities
+ */
+
+
+
+// Workflow start/end log context
+interface WorkflowExecutionContext$1 {
+  type: 'workflow'
+  contextType: 'workflow-execution'
+  executionId: string
+  workflowId: string
+  workflowName?: string
+  organizationId: string
+  executionPath?: string[]
+}
+
+// Workflow failure log context
+interface WorkflowFailureContext$1 {
+  type: 'workflow'
+  contextType: 'workflow-failure'
+  executionId: string
+  workflowId: string
+  error: string
+}
+
+// Step started log context
+interface StepStartedContext$1 {
+  type: 'workflow'
+  contextType: 'step-started'
+  stepId: string
+  stepStatus: 'started'
+  input: unknown
+  startTime: number // Explicit start timestamp for timeline
+}
+
+// Step completed log context
+interface StepCompletedContext$1 {
+  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$1 {
+  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$1 {
+  type: 'workflow'
+  contextType: 'conditional-route'
+  stepId: string
+  target: string
+  error?: string
+}
+
+// Execution path log context
+interface ExecutionPathContext$1 {
+  type: 'workflow'
+  contextType: 'execution-path'
+  executionPath: string[]
+}
+
+// Union of all workflow log contexts
+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)
+ */
+
+
+
+// ============================================================================
+// FORMAL TYPES
+// ============================================================================
+
+/**
+ * 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'
+
+// ============================================================================
+// LIFECYCLE EVENTS (Structural Checkpoints)
+// ============================================================================
+
+/**
+ * Base fields shared by all lifecycle events
+ */
+interface AgentLifecycleEventBase$1 {
+  type: 'agent'
+  agentId: string
+  lifecycle: AgentLifecycle$1
+  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$1 extends AgentLifecycleEventBase$1 {
+  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$1 extends AgentLifecycleEventBase$1 {
+  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$1 extends AgentLifecycleEventBase$1 {
+  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$1 = AgentLifecycleStartedEvent$1 | AgentLifecycleCompletedEvent$1 | AgentLifecycleFailedEvent$1
+
+// ============================================================================
+// ITERATION EVENTS (Execution Activities)
+// ============================================================================
+
+/**
+ * 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' // Always iteration
+  eventType: IterationEventType$1
+  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$1 // For action events
+}
+
+/**
+ * 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' // 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$1 = AgentLifecycleEvent$1 | AgentIterationEvent$1 | AgentToolCallEvent$1
+
+/**
+ * Base execution logger for Execution Engine
+ */
+type ExecutionLogLevel$1 = 'debug' | 'info' | 'warn' | 'error'
+
+
+// Union type for all contexts
+type LogContext$1 = WorkflowLogContext$1 | AgentLogContext$1
+
+// Updated interface with consolidated context
+interface ExecutionLogMessage$1 {
+  level: ExecutionLogLevel$1
+  message: string
+  timestamp: number
+  context?: LogContext$1
+}
+
+/**
+ * Resource Registry type definitions
+ */
+
+
+
+// ============================================================================
+// Core Resource Type Definitions
+// ============================================================================
+
+/**
+ * Environment/deployment status for resources
+ */
+type ResourceStatus$1 = 'dev' | 'prod'
+
+/**
+ * All resource types in the platform
+ * Used as the discriminator field in ResourceDefinition
+ */
+type ResourceType$1 = 'agent' | 'workflow' | 'trigger' | 'integration' | 'external' | 'human'
+
+// Execution status type shared between API and UI
+type ExecutionStatus$1 = 'pending' | 'running' | 'completed' | 'failed' | 'warning'
+
+// API execution types
+interface APIExecutionSummary$1 {
+  id: string
+  status: ExecutionStatus$1
+  startTime: number
+  endTime?: number
+  resourceStatus?: ResourceStatus$1 // 'dev' | 'prod' - optional for backward compatibility
+}
+
+interface APIExecutionDetail$1 extends APIExecutionSummary$1 {
+  executionLogs: ExecutionLogMessage$1[]
+  input?: unknown
+  result?: unknown
+  error?: string
+  resourceStatus: ResourceStatus$1 // Required in detail view
+  apiVersion?: string | null
+  resourceVersion?: string | null
+  sdkVersion?: string | null
+}
+
+// API request/response types
+interface APIExecutionListResponse {
+  executions: APIExecutionSummary$1[]
+}
+
+/**
+ * Fetch the execution list for a given resource.
+ *
+ * resourceStatus and limit are intentionally excluded from the query key so that
+ * SSE invalidations (which target the unfiltered key) bust all filter variants.
+ *
+ * @example
+ * const { data, isLoading } = useExecutions(resourceId)
+ *
+ * @example
+ * // With status filter and limit
+ * const { data } = useExecutions(resourceId, 'running', 20)
+ */
+declare function useExecutions(resourceId: string, resourceStatus?: ResourceStatus$1 | 'all', limit?: number): _tanstack_react_query.UseQueryResult<APIExecutionListResponse, Error>;
+
+/**
+ * Fetch a single execution detail.
+ * Automatically polls every 2 seconds while the execution status is 'running'.
+ *
+ * @example
+ * const { data: execution, isLoading } = useExecution(resourceId, executionId)
+ */
+declare function useExecution(resourceId: string, executionId: string): _tanstack_react_query.UseQueryResult<APIExecutionDetail$1, Error>;
+
+interface ExecuteAsyncParams {
+    resourceId: string;
+    resourceType: ResourceType$1;
+    input: unknown;
+}
+interface ExecuteAsyncResult {
+    executionId: string;
+    status: string;
+    resourceId: string;
+}
+/**
+ * Trigger an async execution for a workflow or agent.
+ * Invalidates the executions list on success so the new execution appears immediately.
+ *
+ * @example
+ * const { mutate: execute, isPending } = useExecuteAsync()
+ * execute({ resourceId, resourceType: 'workflow', input: { ... } })
+ */
+declare function useExecuteAsync(): _tanstack_react_query.UseMutationResult<ExecuteAsyncResult, Error, ExecuteAsyncParams, unknown>;
+
+interface RetryExecutionParams {
+    resourceId: string;
+    resourceType: ResourceType$1;
+    input: unknown;
+}
+/**
+ * Retry a failed execution by re-triggering it async.
+ * Functionally identical to useExecuteAsync but named for intent clarity at call sites.
+ */
+declare function useRetryExecution(): _tanstack_react_query.UseMutationResult<{
+    resourceId: string;
+    executionId: string;
+    status: string;
+}, Error, RetryExecutionParams, unknown>;
+
+interface CancelExecutionParams {
+    resourceId: string;
+    executionId: string;
+}
+interface CancelExecutionResult {
+    cancelled: boolean;
+    method: string;
+    resourceId: string;
+    executionId: string;
+}
+/**
+ * Cancel a running execution.
+ * Invalidates both the execution detail and the executions list on success.
+ *
+ * @example
+ * const { mutate: cancel, isPending } = useCancelExecution()
+ * cancel({ resourceId, executionId })
+ */
+declare function useCancelExecution(): _tanstack_react_query.UseMutationResult<CancelExecutionResult, Error, CancelExecutionParams, unknown>;
+
+interface DeleteExecutionParams {
+    resourceId: string;
+    executionId: string;
+}
+/**
+ * Delete a single execution record.
+ * Removes the execution from cache immediately and invalidates the list.
+ */
+declare function useDeleteExecution(): _tanstack_react_query.UseMutationResult<{
+    resourceId: string;
+    executionId: string;
+}, Error, DeleteExecutionParams, unknown>;
+
+interface BulkDeleteExecutionsParams {
+    resourceId: string;
+    resourceStatus?: ResourceStatus$1 | 'all';
+}
+interface BulkDeleteExecutionsResult {
+    resourceId: string;
+    deletedCount: number;
+    resourceStatus?: ResourceStatus$1 | 'all';
+}
+/**
+ * Bulk delete executions for a resource, optionally filtered by status.
+ */
+declare function useBulkDeleteExecutions(): _tanstack_react_query.UseMutationResult<BulkDeleteExecutionsResult, Error, BulkDeleteExecutionsParams, unknown>;
+
+/**
+ * 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';
+
+/**
+ * Workflow-specific logging types and utilities
+ */
+
+interface WorkflowExecutionContext {
+    type: 'workflow';
+    contextType: 'workflow-execution';
+    executionId: string;
+    workflowId: string;
+    workflowName?: string;
+    organizationId: string;
+    executionPath?: string[];
+}
+interface WorkflowFailureContext {
+    type: 'workflow';
+    contextType: 'workflow-failure';
+    executionId: string;
+    workflowId: string;
+    error: string;
+}
+interface StepStartedContext {
+    type: 'workflow';
+    contextType: 'step-started';
+    stepId: string;
+    stepStatus: 'started';
+    input: unknown;
+    startTime: number;
+}
+interface StepCompletedContext {
+    type: 'workflow';
+    contextType: 'step-completed';
+    stepId: string;
+    stepStatus: 'completed';
+    output: unknown;
+    duration: number;
+    isTerminal: boolean;
+    startTime: number;
+    endTime: number;
+}
+interface StepFailedContext {
+    type: 'workflow';
+    contextType: 'step-failed';
+    stepId: string;
+    stepStatus: 'failed';
+    error: string;
+    duration: number;
+    startTime: number;
+    endTime: number;
+}
+interface ConditionalRouteContext {
+    type: 'workflow';
+    contextType: 'conditional-route';
+    stepId: string;
+    target: string;
+    error?: string;
+}
+interface ExecutionPathContext {
+    type: 'workflow';
+    contextType: 'execution-path';
+    executionPath: string[];
+}
+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)
+ */
+
+/**
+ * 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';
+/**
+ * Base fields shared by all lifecycle events
+ */
+interface AgentLifecycleEventBase {
+    type: 'agent';
+    agentId: string;
+    lifecycle: AgentLifecycle;
+    sessionId?: string;
+}
+/**
+ * Lifecycle started event - emitted when a phase begins
+ * REQUIRED: startTime (phase has started, no end yet)
+ */
+interface AgentLifecycleStartedEvent extends AgentLifecycleEventBase {
+    stage: 'started';
+    startTime: number;
+    iteration?: number;
+}
+/**
+ * Lifecycle completed event - emitted when a phase succeeds
+ * REQUIRED: startTime, endTime, duration (phase has finished successfully)
+ */
+interface AgentLifecycleCompletedEvent extends AgentLifecycleEventBase {
+    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 extends AgentLifecycleEventBase {
+    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 = AgentLifecycleStartedEvent | AgentLifecycleCompletedEvent | AgentLifecycleFailedEvent;
+/**
+ * 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';
+    eventType: IterationEventType;
+    iteration: number;
+    sessionId?: string;
+    startTime: number;
+    endTime: number;
+    duration: number;
+    output?: string;
+    actionType?: string;
+    data?: ActionPlaceholderData;
+}
+/**
+ * Tool call event - captures individual tool executions during iterations
+ * Provides granular timing for each tool invocation
+ */
+interface AgentToolCallEvent {
+    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 = AgentLifecycleEvent | AgentIterationEvent | AgentToolCallEvent;
+
+/**
+ * Base execution logger for Execution Engine
+ */
+type ExecutionLogLevel = 'debug' | 'info' | 'warn' | 'error';
+
+type LogContext = WorkflowLogContext | AgentLogContext;
+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' | '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;
+    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 = '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;
+    originResourceId?: string;
+}
+type TaskScheduleConfig = RecurringScheduleConfig | RelativeScheduleConfig | AbsoluteScheduleConfig;
+interface RecurringScheduleConfig {
+    type: 'recurring';
+    cron?: string;
+    interval?: 'daily' | 'weekly' | 'monthly';
+    time?: string;
+    timezone: string;
+    payload: Record<string, unknown>;
+    endAt?: string | null;
+    overduePolicy?: 'skip' | 'execute';
+}
+interface RelativeScheduleConfig {
+    type: 'relative';
+    anchorAt: string;
+    anchorLabel?: string;
+    items: RelativeScheduleItem[];
+    overduePolicy?: 'skip' | 'execute';
+}
+interface RelativeScheduleItem {
+    offset: string;
+    payload: Record<string, unknown>;
+    label?: string;
+}
+interface AbsoluteScheduleConfig {
+    type: 'absolute';
+    items: AbsoluteScheduleItem[];
+    overduePolicy?: 'skip' | 'execute';
+}
+interface AbsoluteScheduleItem {
+    runAt: string;
+    payload: Record<string, unknown>;
+    label?: string;
+}
+interface TaskSchedule extends ScheduleOriginTracking {
+    id: string;
+    organizationId: string;
+    name: string;
+    description?: string;
+    target: ScheduleTarget;
+    scheduleConfig: TaskScheduleConfig;
+    nextRunAt?: Date;
+    currentStep: number;
+    status: 'active' | 'paused' | 'completed' | 'cancelled';
+    lastRunAt?: Date;
+    lastExecutionId?: string;
+    maxRetries: number;
+    idempotencyKey?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+
+/**
+ * Wire-format DTO for notification API responses.
+ * Dates are ISO 8601 strings (not Date objects like the domain Notification type).
+ * Used by frontend hooks that consume /api/notifications.
+ */
+interface NotificationDTO {
+    id: string;
+    userId: string;
+    organizationId: string;
+    category: string;
+    title: string;
+    message: string;
+    actionUrl: string | null;
+    read: boolean;
+    readAt: string | null;
+    createdAt: string;
+}
+
+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;
+}
+
+/**
+ * Time range selector for dashboard metrics
+ */
+type TimeRange = '1h' | '24h' | '7d' | '30d';
+/**
+ * Execution health metrics response
+ * Success rate, P95 duration, execution counts, and trend data
+ * trendData includes executionCount for throughput visualization (eliminates separate API call)
+ */
+interface ExecutionHealthMetrics {
+    successRate: number;
+    p95Duration: number;
+    totalExecutions: number;
+    trendData: Array<{
+        time: string;
+        rate: number;
+        successCount: number;
+        errorCount: number;
+        warningCount: number;
+        executionCount: number;
+    }>;
+    statusCounts: {
+        success: number;
+        failed: number;
+        pending: number;
+        warning: number;
+    };
+    peakPeriod: string;
+    granularity: 'hour' | 'day';
+}
+/**
+ * Error analysis metrics response
+ * Error categories and top failing resources
+ */
+interface ErrorAnalysisMetrics {
+    totalErrors: number;
+    errorsByCategory: Array<{
+        category: string;
+        count: number;
+        percentage: number;
+    }>;
+    topFailingResources: Array<{
+        resourceId: string;
+        name: string;
+        errorCount: number;
+        failureRate: number;
+    }>;
+}
+/**
+ * Business impact metrics response
+ * ROI, labor savings, and cost analysis
+ */
+interface BusinessImpactMetrics$1 {
+    totalSavingsUsd: number;
+    totalCostUsd: number;
+    netSavingsUsd: number;
+    roi: number;
+}
+/**
+ * Cost breakdown metrics response
+ * Per-resource cost analysis
+ */
+interface CostBreakdownMetrics {
+    resources: Array<{
+        resourceId: string;
+        totalCostUsd: number;
+        executionCount: number;
+        avgCostUsd: number;
+    }>;
+}
+/**
+ * Dashboard metrics response
+ * Aggregates core observability metrics in a single response
+ * Note: Throughput data is now included in executionHealth.trendData.executionCount
+ */
+interface DashboardMetrics {
+    executionHealth: ExecutionHealthMetrics;
+    costBreakdown: CostBreakdownMetrics;
+    businessImpact: BusinessImpactMetrics$1;
+    /** ISO timestamp of the currently active deployment, or null if none */
+    activeDeploymentDate: string | null;
+    /** Deployment version of the active deployment, or null if none */
+    activeDeploymentVersion: string | null;
+}
+/**
+ * Error record for list view (ErrorBreakdownTable)
+ */
+interface ErrorRecord {
+    id: string;
+    timestamp: string;
+    errorType: string;
+    message: string;
+    executionId: string;
+    resourceId: string;
+    resourceName: string;
+    severity: 'critical' | 'warning' | 'info';
+    category: ExecutionErrorCategory;
+    resolved: boolean;
+    resolvedAt: string | null;
+    resolvedBy: string | null;
+}
+/**
+ * Full error detail for modal view (ErrorDetailsModal)
+ */
+interface ErrorDetailFull extends ErrorRecord {
+    stackTrace?: string;
+    retryAttempt?: number;
+    stepName?: string;
+    stepSequence?: number;
+    errorContext?: Record<string, unknown>;
+    executionContext?: Record<string, unknown>;
+}
+/**
+ * Error details API response (paginated)
+ */
+interface ErrorDetailResponse {
+    errors: ErrorRecord[];
+    total: number;
+    page: number;
+    limit: number;
+}
+/**
+ * Error trend data for time-series charts
+ */
+interface ErrorTrend {
+    time: string;
+    errorCount: number;
+    criticalCount: number;
+    warningCount: number;
+    infoCount: number;
+}
+/**
+ * Cost trend data point for time-series charts
+ * Represents a single time bucket (hour or day)
+ */
+interface CostTrendDataPoint {
+    time: string;
+    totalCostUsd: number;
+    executionCount: number;
+    avgCostPerExecution: number;
+}
+/**
+ * Cost trends response (time-series data)
+ */
+interface CostTrendsResponse {
+    trendData: CostTrendDataPoint[];
+    granularity: 'hour' | 'day';
+    totalCostUsd: number;
+    totalExecutions: number;
+}
+/**
+ * Cost summary response with MTD and projections
+ */
+interface CostSummaryResponse {
+    current: {
+        totalCostUsd: number;
+        executionCount: number;
+    };
+    previous: {
+        totalCostUsd: number;
+        executionCount: number;
+    };
+    mtd: {
+        totalCostUsd: number;
+        daysElapsed: number;
+    };
+    projection: {
+        monthlyCostUsd: number;
+        confidence: 'low' | 'medium' | 'high';
+    };
+    trend: {
+        changePercent: number;
+        direction: 'up' | 'down' | 'flat';
+    };
+}
+/**
+ * Cost by model data for model-level breakdown
+ */
+interface CostByModelData {
+    model: string;
+    totalCostUsd: number;
+    callCount: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    avgCostPerCall: number;
+}
+/**
+ * Cost by model response
+ */
+interface CostByModelResponse {
+    models: CostByModelData[];
+    totalCostUsd: number;
+    totalCallCount: number;
+}
+
+/**
+ * Base Execution Engine type definitions
+ * Core types shared across all Execution Engine resources
+ */
+
+/**
+ * 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 = 'pending' | 'running' | 'completed' | 'failed' | 'warning';
+interface APIExecutionSummary {
+    id: string;
+    status: ExecutionStatus;
+    startTime: number;
+    endTime?: number;
+    resourceStatus?: ResourceStatus;
+}
+interface APIExecutionDetail extends APIExecutionSummary {
+    executionLogs: ExecutionLogMessage[];
+    input?: unknown;
+    result?: unknown;
+    error?: string;
+    resourceStatus: ResourceStatus;
+    apiVersion?: string | null;
+    resourceVersion?: string | null;
+    sdkVersion?: string | null;
+}
+
+type ActivityType = 'workflow_execution' | 'agent_run' | 'hitl_action' | 'webhook_received' | 'webhook_executed' | 'webhook_failed' | 'credential_change' | 'api_key_change' | 'deployment_change' | 'membership_change';
+type ActivityStatus = 'success' | 'failure' | 'pending' | 'approved' | 'rejected' | 'completed';
+interface Activity {
+    id: string;
+    organizationId: string;
+    activityType: ActivityType;
+    status: ActivityStatus;
+    title: string;
+    description: string | null;
+    entityType: string;
+    entityId: string;
+    entityName: string | null;
+    metadata: Record<string, unknown> | null;
+    actorId: string | null;
+    actorType: string | null;
+    occurredAt: Date;
+    createdAt: Date;
+}
+
+/**
+ * Execution history item.
+ * Represents a single execution triggered by a schedule.
+ */
+declare const ExecutionHistoryItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodString;
+    status: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        running: "running";
+        cancelled: "cancelled";
+    }>;
+    step: z.ZodNullable<z.ZodNumber>;
+    itemLabel: z.ZodNullable<z.ZodString>;
+    duration: z.ZodNullable<z.ZodNumber>;
+    error: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Execution history response.
+ * Returned by GET /schedules/:id/executions with pagination.
+ */
+declare const ExecutionHistoryResponseSchema: z.ZodObject<{
+    executions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        createdAt: z.ZodString;
+        status: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            running: "running";
+            cancelled: "cancelled";
+        }>;
+        step: z.ZodNullable<z.ZodNumber>;
+        itemLabel: z.ZodNullable<z.ZodString>;
+        duration: z.ZodNullable<z.ZodNumber>;
+        error: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    limit: z.ZodNumber;
+    offset: z.ZodNumber;
+}, z.core.$strip>;
+type ExecutionHistoryItem = z.infer<typeof ExecutionHistoryItemSchema>;
+type ExecutionHistoryResponse = z.infer<typeof ExecutionHistoryResponseSchema>;
+
+/**
+ * Fetch all available Execution Engine resources (workflows, agents, pipelines).
+ *
+ * @example
+ * const { data, isLoading } = useResources()
+ * const workflows = data?.workflows ?? []
+ * const agents = data?.agents ?? []
+ */
+declare function useResources(): _tanstack_react_query.UseQueryResult<{
+    workflows: ResourceDefinition[];
+    agents: ResourceDefinition[];
+    pipelines: ResourceDefinition[];
+    total: number;
+}, Error>;
+
+/**
+ * Fetch a resource definition (workflow steps, agent actions, etc.).
+ *
+ * @param resourceId - The resource ID to fetch
+ * @param enabled - Whether the query should execute (default: true)
+ */
+declare function useResourceDefinition(resourceId: string, enabled?: boolean): _tanstack_react_query.UseQueryResult<AIResourceDefinition, Error>;
+
+/**
+ * Query key factory for schedule cache management.
+ * Provides type-safe, hierarchical keys for TanStack Query.
+ * Uses organizationId (UUID) for tenant-scoped cache isolation.
+ */
+declare const scheduleKeys: {
+    all: (orgId: string | null) => readonly ["schedules", string | null];
+    lists: (orgId: string | null) => readonly ["schedules", string | null, "list"];
+    list: (orgId: string | null, filters?: ListSchedulesFilters) => readonly ["schedules", string | null, "list", ListSchedulesFilters | undefined];
+    details: (orgId: string | null) => readonly ["schedules", string | null, "detail"];
+    detail: (orgId: string | null, id: string) => readonly ["schedules", string | null, "detail", string];
+    executions: (orgId: string | null, id: string) => readonly ["schedules", string | null, "detail", string, "executions"];
+};
+/**
+ * Filters for list schedules query.
+ * Mirrors ListSchedulesQuery from @repo/core but typed for UI consumption.
+ */
+interface ListSchedulesFilters {
+    status?: 'active' | 'paused' | 'completed' | 'cancelled';
+    targetResourceType?: 'agent' | 'workflow';
+    targetResourceId?: string;
+    limit?: number;
+    offset?: number;
+}
+
+interface CreateScheduleInput {
+    name: string;
+    description?: string;
+    target: {
+        resourceType: 'agent' | 'workflow';
+        resourceId: string;
+    };
+    scheduleConfig: TaskScheduleConfig;
+    maxRetries?: number;
+    idempotencyKey?: string;
+    originExecutionId?: string;
+    originResourceType?: 'agent' | 'workflow' | 'scheduler' | 'api';
+    originResourceId?: string;
+}
+interface UpdateScheduleInput {
+    id: string;
+    name?: string;
+    description?: string | null;
+    scheduleConfig?: TaskScheduleConfig;
+    maxRetries?: number;
+}
+/** List response using domain type for CC compatibility. */
+interface ListSchedulesResponse {
+    schedules: TaskSchedule[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/**
+ * List schedules with optional filters.
+ *
+ * @param filters - Optional filters for status, target resource, and pagination
+ * @returns TanStack Query result with schedules array and pagination info
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useListSchedules({ status: 'active', limit: 20 })
+ * ```
+ */
+declare function useListSchedules(filters?: ListSchedulesFilters): _tanstack_react_query.UseQueryResult<ListSchedulesResponse, Error>;
+/**
+ * Get a single schedule by ID.
+ *
+ * @param id - Schedule UUID (undefined to disable query)
+ * @returns TanStack Query result with schedule data
+ *
+ * @example
+ * ```tsx
+ * const { data: schedule, isLoading } = useGetSchedule(scheduleId)
+ * ```
+ */
+declare function useGetSchedule(id: string | undefined): _tanstack_react_query.UseQueryResult<TaskSchedule, Error>;
+/**
+ * Get execution history for a schedule.
+ *
+ * @param scheduleId - Schedule UUID (undefined to disable query)
+ * @param options - Pagination options (limit, offset)
+ * @returns TanStack Query result with execution history and pagination info
+ *
+ * @example
+ * ```tsx
+ * const { data } = useGetExecutionHistory(scheduleId, { limit: 10 })
+ * ```
+ */
+declare function useGetExecutionHistory(scheduleId: string | undefined, options?: {
+    limit?: number;
+    offset?: number;
+}): _tanstack_react_query.UseQueryResult<{
+    executions: {
+        id: string;
+        createdAt: string;
+        status: "completed" | "failed" | "running" | "cancelled";
+        step: number | null;
+        itemLabel: string | null;
+        duration: number | null;
+        error: string | null;
+    }[];
+    total: number;
+    limit: number;
+    offset: number;
+}, Error>;
+/**
+ * Create a new schedule.
+ *
+ * @returns TanStack Mutation for creating schedules
+ *
+ * @example
+ * ```tsx
+ * const createSchedule = useCreateSchedule()
+ *
+ * createSchedule.mutate({
+ *   name: 'Daily Report',
+ *   target: { resourceType: 'workflow', resourceId: 'wf-123' },
+ *   scheduleConfig: { type: 'recurring', cron: '0 9 * * *', timezone: 'UTC', payload: {} }
+ * })
+ * ```
+ */
+declare function useCreateSchedule(): _tanstack_react_query.UseMutationResult<TaskSchedule, Error, CreateScheduleInput, unknown>;
+/**
+ * Update schedule fields (name, description, scheduleConfig, maxRetries).
+ * Only active or paused schedules can be updated.
+ *
+ * @returns TanStack Mutation for updating schedules
+ *
+ * @example
+ * ```tsx
+ * const updateSchedule = useUpdateSchedule()
+ *
+ * updateSchedule.mutate({ id: 'schedule-123', name: 'Updated Name' })
+ * ```
+ */
+declare function useUpdateSchedule(): _tanstack_react_query.UseMutationResult<TaskSchedule, Error, UpdateScheduleInput, unknown>;
+/**
+ * Update anchor datetime for relative schedules.
+ * Only applicable to schedules with type: 'relative'.
+ *
+ * @returns TanStack Mutation for updating schedule anchor
+ *
+ * @example
+ * ```tsx
+ * const updateAnchor = useUpdateAnchor()
+ *
+ * updateAnchor.mutate({ id: 'schedule-123', anchorAt: '2026-02-01T09:00:00Z' })
+ * ```
+ */
+declare function useUpdateAnchor(): _tanstack_react_query.UseMutationResult<TaskSchedule, Error, {
+    id: string;
+    anchorAt: string;
+}, unknown>;
+/**
+ * Pause a schedule.
+ * Paused schedules will not execute until resumed.
+ *
+ * @returns TanStack Mutation for pausing schedules
+ *
+ * @example
+ * ```tsx
+ * const pauseSchedule = usePauseSchedule()
+ * pauseSchedule.mutate('schedule-123')
+ * ```
+ */
+declare function usePauseSchedule(): _tanstack_react_query.UseMutationResult<TaskSchedule, Error, string, unknown>;
+/**
+ * Resume a paused schedule.
+ *
+ * @returns TanStack Mutation for resuming schedules
+ *
+ * @example
+ * ```tsx
+ * const resumeSchedule = useResumeSchedule()
+ * resumeSchedule.mutate('schedule-123')
+ * ```
+ */
+declare function useResumeSchedule(): _tanstack_react_query.UseMutationResult<TaskSchedule, Error, string, unknown>;
+/**
+ * Cancel a schedule permanently (soft delete).
+ * Sets status to 'cancelled' -- schedule remains in DB for history.
+ * Cancelled schedules cannot be resumed.
+ *
+ * @returns TanStack Mutation for cancelling schedules
+ *
+ * @example
+ * ```tsx
+ * const cancelSchedule = useCancelSchedule()
+ * cancelSchedule.mutate('schedule-123')
+ * ```
+ */
+declare function useCancelSchedule(): _tanstack_react_query.UseMutationResult<TaskSchedule, Error, string, unknown>;
+/**
+ * Delete a schedule permanently (hard delete).
+ * Removes schedule from database entirely.
+ *
+ * @returns TanStack Mutation for deleting schedules
+ *
+ * @example
+ * ```tsx
+ * const deleteSchedule = useDeleteSchedule()
+ * deleteSchedule.mutate('schedule-123')
+ * ```
+ */
+declare function useDeleteSchedule(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+
+interface UseActivitiesParams {
+    limit?: number;
+    offset?: number;
+    activityType?: ActivityType;
+    entityType?: string;
+    entityId?: string;
+    startDate?: string;
+    endDate?: string;
+    status?: string;
+    search?: string;
+}
+interface ListActivitiesResponse {
+    activities: Activity[];
+    total: number;
+}
+/**
+ * Fetch activities with filtering and pagination
+ *
+ * @example
+ * // Basic usage - fetch recent activities
+ * const { data, error, isLoading } = useActivities({ limit: 50 })
+ *
+ * @example
+ * // Filtered by type
+ * const { data } = useActivities({
+ *   activityType: 'workflow_execution',
+ *   limit: 20
+ * })
+ *
+ * @example
+ * // Filtered by entity
+ * const { data } = useActivities({
+ *   entityType: 'workflow',
+ *   entityId: 'workflow-123'
+ * })
+ */
+interface ActivityTrendResponse {
+    timestamps: Date[];
+    total: number;
+}
+type UseActivityTrendParams = Omit<UseActivitiesParams, 'limit' | 'offset' | 'search' | 'status'>;
+/**
+ * Fetch activity timestamps for the Activity Trend chart
+ *
+ * Uses /activities/trend endpoint which returns only occurred_at timestamps
+ * up to ANALYTICS_SAFETY_LIMIT (10,000), bypassing the MAX_PAGE_LIMIT cap.
+ * Provides accurate counts for any time range regardless of activity volume.
+ */
+declare function useActivityTrend(params?: UseActivityTrendParams): _tanstack_react_query.UseQueryResult<ActivityTrendResponse, Error>;
+declare function useActivities(params?: UseActivitiesParams): _tanstack_react_query.UseQueryResult<ListActivitiesResponse, Error>;
+
+interface UseExecutionLogsParams {
+    resourceId?: string;
+    status?: ExecutionStatus | 'all';
+    resourceStatus?: 'dev' | 'prod' | 'all';
+    startDate?: number;
+    endDate?: number;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Response type for cross-resource execution list
+ * Matches backend ExecutionLogsPageResponse in apps/api/src/execution-engine/handlers.ts
+ */
+interface ExecutionLogsPageResponse {
+    executions: Array<{
+        id: string;
+        resourceId: string;
+        resourceName: string;
+        resourceType: 'workflow' | 'agent' | 'pipeline';
+        status: ExecutionStatus;
+        startTime: number;
+        endTime?: number;
+        duration?: number;
+        resourceStatus: 'dev' | 'prod';
+        resourceVersion?: string | null;
+        apiVersion?: string | null;
+        sdkVersion?: string | null;
+    }>;
+    total: number;
+    hasMore: boolean;
+}
+/**
+ * Fetch execution logs across all resources with filtering and pagination
+ *
+ * @example
+ * // Basic usage - fetch recent executions
+ * const { data, error, isLoading } = useExecutionLogs({ limit: 50 })
+ *
+ * @example
+ * // Filtered by status
+ * const { data } = useExecutionLogs({
+ *   status: 'failed',
+ *   limit: 20
+ * })
+ *
+ * @example
+ * // Filtered by resource and date range
+ * const { data } = useExecutionLogs({
+ *   resourceId: 'workflow-123',
+ *   startDate: Date.now() - 86400000, // Last 24 hours
+ *   endDate: Date.now()
+ * })
+ */
+declare function useExecutionLogs(params?: UseExecutionLogsParams): _tanstack_react_query.UseQueryResult<ExecutionLogsPageResponse, Error>;
+
+interface UseNotificationsOptions {
+    limit?: number;
+    offset?: number;
+}
+declare function useNotifications({ limit, offset }?: UseNotificationsOptions): _tanstack_react_query.UseQueryResult<{
+    notifications: NotificationDTO[];
+    total: number;
+}, Error>;
+
+declare function useCostSummary(timeRange: TimeRange): _tanstack_react_query.UseQueryResult<CostSummaryResponse, Error>;
+
+interface UseExecutionHealthParams {
+    timeRange: TimeRange;
+}
+declare function useExecutionHealth({ timeRange }: UseExecutionHealthParams): _tanstack_react_query.UseQueryResult<DashboardMetrics, Error>;
+
+/**
+ * Query key factories for observability hooks.
+ * Scoped by organizationId for cache isolation between tenants.
+ */
+declare const observabilityKeys: {
+    all: readonly ["observability"];
+    errorAnalysis: (organizationId: string | null, timeRange: string) => readonly ["observability", "error-analysis", string | null, string];
+    errorDetails: (organizationId: string | null, filters: object) => readonly ["observability", "error-details", string | null, object];
+    errorDetail: (organizationId: string | null, executionId: string | null) => readonly ["observability", "error-detail", string | null, string | null];
+    errorTrends: (organizationId: string | null, startDate: string, endDate: string, granularity: string) => readonly ["observability", "error-trends", string | null, string, string, string];
+    errorDistribution: (organizationId: string | null, startDate: string, endDate: string, groupBy: string) => readonly ["observability", "error-distribution", string | null, string, string, string];
+    topFailingResources: (organizationId: string | null, startDate: string, endDate: string, limit: number) => readonly ["observability", "top-failing-resources", string | null, string, string, number];
+    costTrends: (organizationId: string | null, timeRange: string, granularity: string) => readonly ["observability", "cost-trends", string | null, string, string];
+    costByModel: (organizationId: string | null, timeRange: string) => readonly ["observability", "cost-by-model", string | null, string];
+    costBreakdown: (organizationId: string | null, timeRange: string) => readonly ["observability", "cost-breakdown", string | null, string];
+    dashboardMetrics: (organizationId: string | null, timeRange: string) => readonly ["observability", "dashboard-metrics", string | null, string];
+    businessImpact: (organizationId: string | null, timeRange: string) => readonly ["observability", "business-impact", string | null, string];
+};
+
+declare function useErrorAnalysis(timeRange: TimeRange): _tanstack_react_query.UseQueryResult<ErrorAnalysisMetrics, Error>;
+
+interface ErrorFilters {
+    errorType?: string;
+    severity?: 'critical' | 'warning' | 'info';
+    search?: string;
+    startDate?: string;
+    endDate?: string;
+    page?: number;
+    limit?: number;
+    /** When true, show only resolved errors. When false, show only unresolved. Omit to show all. */
+    resolved?: boolean;
+}
+declare function useErrorDetails(filters: ErrorFilters): _tanstack_react_query.UseQueryResult<ErrorDetailResponse, Error>;
+declare function useErrorDetail(executionId: string | null): _tanstack_react_query.UseQueryResult<ErrorDetailFull[] | null, Error>;
+
+interface ErrorTrendsParams {
+    startDate: string;
+    endDate: string;
+    granularity: 'hour' | 'day';
+}
+declare function useErrorTrends({ startDate, endDate, granularity }: ErrorTrendsParams): _tanstack_react_query.UseQueryResult<ErrorTrend[], Error>;
+
+interface ErrorDistributionParams {
+    startDate: string;
+    endDate: string;
+    groupBy: 'errorType' | 'resource' | 'severity';
+}
+interface ErrorDistributionItem {
+    label: string;
+    count: number;
+    percentage: number;
+}
+declare function useErrorDistribution({ startDate, endDate, groupBy }: ErrorDistributionParams): _tanstack_react_query.UseQueryResult<ErrorDistributionItem[], Error>;
+
+interface TopFailingResourcesParams {
+    startDate: string;
+    endDate: string;
+    limit?: number;
+}
+interface FailingResource {
+    resourceId: string;
+    resourceType: string;
+    errorCount: number;
+    failureRate: number;
+}
+declare function useTopFailingResources({ startDate, endDate, limit }: TopFailingResourcesParams): _tanstack_react_query.UseQueryResult<FailingResource[], Error>;
+
+/**
+ * Resolve a single error by ID.
+ */
+declare function useResolveError(): _tanstack_react_query.UseMutationResult<unknown, Error, string, unknown>;
+/**
+ * Unresolve a previously resolved error.
+ */
+declare function useUnresolveError(): _tanstack_react_query.UseMutationResult<unknown, Error, string, unknown>;
+/**
+ * Resolve all errors in the organization.
+ */
+declare function useResolveAllErrors(): _tanstack_react_query.UseMutationResult<unknown, Error, void, unknown>;
+/**
+ * Resolve all errors for a specific execution.
+ */
+declare function useResolveErrorsByExecution(): _tanstack_react_query.UseMutationResult<unknown, Error, string, unknown>;
+
+declare function useCostTrends(timeRange: TimeRange, granularity?: 'hour' | 'day' | 'week'): _tanstack_react_query.UseQueryResult<CostTrendsResponse, Error>;
+
+declare function useCostByModel(timeRange: TimeRange): _tanstack_react_query.UseQueryResult<CostByModelResponse, Error>;
+
+interface CostBreakdownItem {
+    resourceId: string;
+    resourceType: string;
+    model: string;
+    totalCost: number;
+    executionCount: number;
+}
+declare function useCostBreakdown(timeRange: TimeRange): _tanstack_react_query.UseQueryResult<CostBreakdownItem[], Error>;
+
+declare function useDashboardMetrics(timeRange: TimeRange): _tanstack_react_query.UseQueryResult<unknown, Error>;
+
+interface BusinessImpactMetrics {
+    totalExecutions: number;
+    estimatedTimeSavedMinutes: number;
+    estimatedCostSavings: number;
+    automationROI: number;
+}
+declare function useBusinessImpact(timeRange: TimeRange): _tanstack_react_query.UseQueryResult<BusinessImpactMetrics, Error>;
+
+declare function useMarkAsRead(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+
+declare function useMarkAllAsRead(): _tanstack_react_query.UseMutationResult<void, Error, void, unknown>;
+
+/**
+ * API-only hook for unread notification count.
+ *
+ * For SSE-enhanced real-time counts, consumers should provide
+ * the count via props (e.g., NotificationBell's `unreadCount` prop).
+ */
+declare function useNotificationCount(): _tanstack_react_query.UseQueryResult<number, Error>;
+
+/**
+ * Hook that provides a standardized error notification handler
+ * for use in React Query mutation hooks.
+ *
+ * Delegates to the active NotificationAdapter so it works in any
+ * consumer (Mantine, Sonner, console fallback, etc.)
+ *
+ * @example
+ * ```typescript
+ * const mutation = useMutation({
+ *   mutationFn: deleteApiKey,
+ *   onError: useErrorNotification()
+ * })
+ * ```
+ */
+declare function useErrorNotification(): (error: unknown) => void;
+
+/**
+ * Hook that provides a standardized success notification handler.
+ * Delegates to the active NotificationAdapter.
+ */
+declare function useSuccessNotification(): (title: string, message: string) => void;
+
+/**
+ * Hook that provides a standardized warning notification handler.
+ * Delegates to the active NotificationAdapter.
+ */
+declare function useWarningNotification(): (title: string, message: string) => void;
+
+/**
+ * Generic batch delete hook. Deletes multiple rows from a Supabase table by ID.
+ *
+ * @param tableName - Supabase table name (e.g. 'acq_social_posts')
+ * @param invalidateQueryKeys - Array of query key prefixes to invalidate on success
+ */
+declare function useBatchDelete(tableName: string, invalidateQueryKeys: readonly (readonly unknown[])[]): _tanstack_react_query.UseMutationResult<void, Error, string[], unknown>;
+
+interface SessionListItem {
+    sessionId: string;
+    resourceId: string;
+    turnCount: number;
+    isEnded: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface CreateSessionResponse {
+    sessionId: string;
+    resourceId: string;
+    turnCount: number;
+    createdAt: string;
+}
+/**
+ * Response type from the /api/dev/execution-engine/resources endpoint
+ */
+interface ResourcesResponse {
+    workflows: ResourceDefinition[];
+    agents: ResourceDefinition[];
+    pipelines: ResourceDefinition[];
+}
+/**
+ * Operations Service for fetching Execution Engine resources
+ */
+declare class OperationsService {
+    private apiRequest;
+    constructor(apiRequest: <T>(endpoint: string, options?: RequestInit) => Promise<T>);
+    /**
+     * Fetch all available Execution Engine resources
+     * Uses the unified /list-resources endpoint
+     */
+    getResources(): Promise<ResourcesResponse>;
+    /**
+     * Get detailed workflow information
+     * Optional: For future detailed views
+     */
+    getWorkflowDetails(): Promise<ResourceDefinition[]>;
+    /**
+     * Get detailed agent information
+     * Optional: For future detailed views
+     */
+    getAgentDetails(): Promise<ResourceDefinition[]>;
+    /**
+     * Get detailed pipeline information
+     * Optional: For future detailed views
+     */
+    getPipelineDetails(): Promise<ResourceDefinition[]>;
+    /**
+     * Get resource definition (workflow steps, agent actions, pipeline stages, etc.)
+     */
+    getResourceDefinition(resourceId: string): Promise<AIResourceDefinition>;
+    /**
+     * List sessions with optional filtering
+     */
+    listSessions(params?: {
+        resourceId?: string;
+    }): Promise<SessionListItem[]>;
+    /**
+     * Get session details by ID
+     */
+    getSession(sessionId: string): Promise<SessionDTO>;
+    /**
+     * Create a new session for an agent
+     */
+    createSession(resourceId: string): Promise<CreateSessionResponse>;
+    /**
+     * Archive a session
+     */
+    archiveSession(sessionId: string): Promise<void>;
+}
+
+/**
+ * Shared hook for pagination state management.
+ * Encapsulates page state, offset calculation, and reset-on-filter-change.
+ *
+ * @param pageSize - Number of items per page
+ * @param resetDeps - When any dependency changes, page resets to 1. Omit to disable auto-reset.
+ * @param total - When provided, automatically retreats to the last valid page if the current page becomes empty (e.g., after bulk deletion).
+ */
+declare function usePaginationState(pageSize: number, resetDeps?: unknown[], total?: number): {
+    page: number;
+    setPage: react.Dispatch<react.SetStateAction<number>>;
+    offset: number;
+    totalPages: (total: number) => number;
+};
+
+/**
+ * Generic table row selection hook.
+ * Tracks selected IDs, provides toggle/toggleAll/clear, and computes selection state.
+ *
+ * @param items - Current page items (must have `id: string`)
+ * @param allItems - All items across all pages (for "select all" to work across pages). Defaults to `items`.
+ */
+declare function useTableSelection<T extends {
+    id: string;
+}>(items: T[], allItems?: T[]): {
+    selectedIds: Set<string>;
+    toggle: (id: string) => void;
+    togglePage: () => void;
+    clear: () => void;
+    isPageAllSelected: boolean;
+    isPagePartiallySelected: boolean;
+    selectedCount: number;
+    isSelected: (id: string) => boolean;
+};
+
+type SortDirection = 'asc' | 'desc';
+interface SortState {
+    column: string;
+    direction: SortDirection;
+}
+/**
+ * Generic table sorting hook.
+ * Manages sort column + direction, and provides a sort utility for client-side data.
+ */
+declare function useTableSort(defaultColumn: string, defaultDirection?: SortDirection): {
+    sort: SortState;
+    toggleSort: (column: string) => void;
+};
+/**
+ * Sort an array of items by a column using accessor functions.
+ *
+ * @param data - Array to sort (not mutated)
+ * @param sort - Current sort state
+ * @param accessors - Map of column name → accessor function
+ */
+declare function sortData<T>(data: T[], sort: SortState, accessors: Record<string, (item: T) => string | number | boolean | null | undefined>): T[];
+/**
+ * Hook that combines useTableSort with memoized sortData.
+ * Returns the sort state, toggle function, and a memoized sort function.
+ */
+declare function useSortedData<T>(data: T[], defaultColumn: string, accessors: Record<string, (item: T) => string | number | boolean | null | undefined>, defaultDirection?: SortDirection): {
+    sorted: T[];
+    sort: SortState;
+    toggleSort: (column: string) => void;
+};
+
+interface InitializationError {
+    layer: 'auth' | 'profile' | 'organization';
+    message: string;
+    originalError?: Error;
+}
+interface AppInitializationState {
+    userReady: boolean;
+    organizationReady: boolean;
+    allReady: boolean;
+    isInitializing: boolean;
+    error: InitializationError | null;
+    retry: () => void;
+    profile: SupabaseUserProfile | null;
+}
+
+/**
+ * The value exposed by OrganizationProvider to all consumers.
+ */
+interface OrganizationContextValue {
+    /** WorkOS organization ID of the currently selected organization. */
+    currentWorkOSOrganizationId: string | null;
+    /** Supabase (UUID) organization ID of the currently selected organization. */
+    currentSupabaseOrganizationId: string | null;
+    /** Full membership record for the currently selected organization. */
+    currentMembership: MembershipWithDetails | null;
+    /** All memberships for the authenticated user. */
+    memberships: MembershipWithDetails[];
+    /** True while the initial membership list is being fetched. */
+    isInitializing: boolean;
+    /** True while a subsequent org switch / refresh is in flight. */
+    isOrgRefreshing: boolean;
+    /** Error message if the membership fetch or org switch failed. */
+    error: string | null;
+    /**
+     * Switch the active organization.
+     *
+     * Persists the selection to `last_visited_org` on the user profile and
+     * invalidates all org-scoped TanStack Query cache entries.
+     *
+     * @param workosOrgId - WorkOS organization ID to switch to.
+     */
+    switchOrganization: (workosOrgId: string) => void;
+    /**
+     * Re-fetch memberships and retry org selection after an error.
+     */
+    retry: () => Promise<void>;
+}
+
+type RestrictionSource = 'org' | 'membership' | null;
+interface FeatureAccessResult {
+    allowed: boolean;
+    restrictedBy: RestrictionSource;
+}
+/**
+ * Factory that creates a `useFeatureAccess` hook scoped to the consumer's
+ * feature configuration.
+ *
+ * @param useInitialization - Initialization hook providing `profile` and `organizationReady`
+ * @param useOrganization   - Organization hook providing `currentMembership`
+ * @param optInFeatures     - Feature keys that are disabled by default (must be explicitly enabled)
+ *
+ * @example
+ * ```typescript
+ * // In your app's feature-access module
+ * import { createUseFeatureAccess } from '@repo/ui/hooks'
+ * import { useInitialization } from '@repo/ui/initialization'
+ * import { useOrganization } from '@repo/ui/organization'
+ *
+ * export const useFeatureAccess = createUseFeatureAccess({
+ *   useInitialization,
+ *   useOrganization,
+ *   optInFeatures: ['acquisition', 'calibration'],
+ * })
+ * ```
+ */
+declare function createUseFeatureAccess({ useInitialization, useOrganization, optInFeatures }: {
+    useInitialization: () => Pick<AppInitializationState, 'profile' | 'organizationReady'>;
+    useOrganization: () => Pick<OrganizationContextValue, 'currentMembership'>;
+    optInFeatures?: string[];
+}): () => {
+    orgConfig: OrgFeatureConfig | undefined;
+    membershipConfig: OrgFeatureConfig | undefined;
+    userConfig: UserConfig | undefined;
+    hasFeature: (featureKey: string) => boolean;
+    checkFeature: (featureKey: string) => FeatureAccessResult;
+    isReady: boolean;
+};
+
+interface EventSourceMessage {
+    id: string;
+    event: string;
+    data: string;
+    retry?: number;
+}
+
+interface FetchEventSourceWithTokenRefreshOptions {
+    url: string;
+    getToken: () => Promise<string | undefined>;
+    headers?: Record<string, string>;
+    signal: AbortSignal;
+    /** Delay in ms before reconnecting after token refresh. Defaults to 2000. */
+    tokenRefreshDelayMs?: number;
+    onopen?: (response: Response) => void | Promise<void>;
+    onmessage?: (event: EventSourceMessage) => void;
+    onerror?: (error: unknown) => void;
+    onclose?: () => void;
+}
+
+interface SSEConnectionManagerOptions {
+    /** Grace period in ms before closing idle connections. Defaults to 5000. */
+    closeGracePeriodMs?: number;
+}
+/**
+ * SSE Connection Manager
+ *
+ * Ensures only ONE SSE connection exists per endpoint, preventing duplicate
+ * connections when components re-render or remount.
+ *
+ * Benefits:
+ * - Prevents resource waste from duplicate connections
+ * - Eliminates race conditions from overlapping connections
+ * - Automatically manages connection lifecycle
+ * - Shares single connection across multiple subscribers
+ */
+declare class SSEConnectionManager {
+    private connections;
+    private closeGracePeriodMs;
+    constructor(options?: SSEConnectionManagerOptions);
+    /**
+     * Subscribe to an SSE endpoint
+     *
+     * If a connection already exists for this endpoint, reuses it.
+     * Otherwise, creates a new connection.
+     *
+     * @param key - Unique identifier for the connection (e.g., 'notifications', 'resource-executive-agent')
+     * @param subscriberId - Unique identifier for this subscriber (usually component instance)
+     * @param options - SSE connection options
+     * @returns Unsubscribe function to call when component unmounts
+     */
+    subscribe(key: string, subscriberId: string, options: Omit<FetchEventSourceWithTokenRefreshOptions, 'signal'>): () => void;
+    /**
+     * Unsubscribe from an SSE endpoint
+     *
+     * If this is the last subscriber, closes the connection after grace period.
+     */
+    private unsubscribe;
+    /**
+     * Force close a connection and all its subscribers
+     */
+    closeConnection(key: string): void;
+    /**
+     * Get current connection status
+     */
+    getConnectionInfo(): Map<string, {
+        url: string;
+        subscribers: number;
+    }>;
+}
+
+interface UseSSEConnectionOptions {
+    manager: SSEConnectionManager;
+    /** Shared connection key — all subscribers with the same key share ONE connection. */
+    connectionKey: string;
+    url: string;
+    /** When false the subscription is skipped. Defaults to true. */
+    enabled?: boolean;
+    headers?: Record<string, string>;
+    /** Called for each non-empty SSE message with the raw `event.data` string. */
+    onmessage: (data: string) => void;
+    /**
+     * Called when the connection opens. Return a non-empty string to set it as
+     * the error state (e.g. `response.status === 403 ? 'Access denied' : undefined`).
+     */
+    onopen?: (response: Response) => string | void;
+    onerror?: (err: Error) => void;
+    onclose?: () => void;
+}
+/**
+ * Generic SSE subscription hook.
+ *
+ * Handles token refresh, connection state, subscriber ID generation, and
+ * subscribe/cleanup lifecycle via the shared SSEConnectionManager.
+ *
+ * Domain-specific event parsing (e.g. `ExecutionSSEEvent`) stays in the
+ * caller's `onmessage` handler.
+ *
+ * @example
+ * ```typescript
+ * const { connected, error } = useSSEConnection({
+ *   manager: sseConnectionManager,
+ *   connectionKey: `resource-${resourceId}`,
+ *   url: `${API_URL}/api/execution-engine/sse/${resourceId}`,
+ *   enabled: isOrganizationReady,
+ *   headers: { [HTTP_HEADERS.WORKOS_ORGANIZATION_ID]: orgId },
+ *   onmessage: (data) => {
+ *     const event = JSON.parse(data)
+ *     // handle domain-specific event
+ *   },
+ * })
+ * ```
+ */
+declare function useSSEConnection({ manager, connectionKey, url, enabled, headers, onmessage, onopen, onerror, onclose }: UseSSEConnectionOptions): {
+    connected: boolean;
+    error: string | null;
+};
+
+/**
+ * Session-scoped query key factory.
+ * Organization identifier is always included for cache isolation.
+ */
+declare const sessionsKeys: {
+    all: readonly ["sessions"];
+    sessions: (org: string, params?: {
+        resourceId?: string;
+    }) => readonly ["sessions", "list", string, {
+        resourceId?: string;
+    } | undefined];
+    session: (org: string, sessionId: string) => readonly ["sessions", "detail", string, string];
+    executions: (org: string, sessionId: string) => readonly ["sessions", string, string, "executions"];
+    execution: (org: string, sessionId: string, executionId: string) => readonly ["sessions", string, string, "executions", string];
+    messages: (org: string, sessionId: string) => readonly ["sessions", string, string, "messages"];
+};
+
+interface SessionExecution {
+    executionId: string;
+    turnNumber: number;
+    status: string;
+    startedAt: string;
+    completedAt?: string;
+    duration?: number;
+}
+interface SessionExecutionsResponse {
+    sessionId: string;
+    executions: SessionExecution[];
+}
+interface GetMessagesResponse {
+    sessionId: string;
+    messages: Array<{
+        id: string;
+        role: 'user' | 'assistant';
+        messageType: MessageType;
+        text: string;
+        metadata?: MessageEvent;
+        turnNumber: number;
+        messageIndex?: number;
+        createdAt: string;
+    }>;
+}
+interface WebSocketState {
+    isConnected: boolean;
+    isProcessing: boolean;
+    error: string | null;
+}
+
+/** Refetch interval for running executions (ms) */
+declare const REFETCH_INTERVAL_RUNNING = 2000;
+/** WebSocket reconnection: base delay (ms) */
+declare const WS_RECONNECT_BASE_DELAY = 1000;
+/** WebSocket reconnection: max delay (ms) */
+declare const WS_RECONNECT_MAX_DELAY = 30000;
+/** WebSocket reconnection: retries before showing error */
+declare const WS_MAX_RETRIES_BEFORE_ERROR = 3;
+
+/**
+ * Hook to fetch sessions list with optional filtering.
+ */
+declare function useSessions(params?: {
+    resourceId?: string;
+}, options?: {
+    enabled?: boolean;
+}): _tanstack_react_query.UseQueryResult<SessionListItem[], Error>;
+/**
+ * Hook to fetch a single session by ID.
+ */
+declare function useSession(sessionId: string): _tanstack_react_query.UseQueryResult<SessionDTO, Error>;
+/**
+ * Hook to create a new session.
+ */
+declare function useCreateSession(): _tanstack_react_query.UseMutationResult<CreateSessionResponse, Error, string, unknown>;
+/**
+ * Hook to delete a session.
+ */
+declare function useDeleteSession(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+/**
+ * Hook to archive a session.
+ */
+declare function useArchiveSession(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+
+/**
+ * Hook to fetch all executions for a session, grouped by turn.
+ * Each turn creates one execution.
+ */
+declare function useSessionExecutions(sessionId: string): _tanstack_react_query.UseQueryResult<SessionExecutionsResponse, Error>;
+/**
+ * Hook to fetch a single execution detail for a session turn.
+ * Auto-refetches every 2 seconds while the execution is still running.
+ */
+declare function useSessionExecution(sessionId: string, executionId: string): _tanstack_react_query.UseQueryResult<APIExecutionDetail, Error>;
+
+/**
+ * Hook to fetch message history for a session.
+ * Transforms ISO date strings to Date objects on the returned messages.
+ */
+declare function useSessionMessages(sessionId: string): _tanstack_react_query.UseQueryResult<ChatMessage[], Error>;
+
+/**
+ * WebSocket hook for real-time agent chat sessions.
+ * Connects to backend WebSocket endpoint with authentication.
+ * Auto-reconnects with exponential backoff.
+ *
+ * @param sessionId - The session to connect to.
+ * @param apiUrl - Base URL of the API server (e.g. "https://api.example.com").
+ *                 Callers typically obtain this from their service configuration.
+ */
+declare function useSessionWebSocket(sessionId: string, apiUrl: string): {
+    messages: ChatMessage[];
+    state: WebSocketState;
+    sendMessage: (text: string, pageContext?: Record<string, unknown>) => void;
+    clearError: () => void;
+    lastTokenUsage: SessionTokenUsage | null;
+};
+
+export { OperationsService, REFETCH_INTERVAL_RUNNING, WS_MAX_RETRIES_BEFORE_ERROR, WS_RECONNECT_BASE_DELAY, WS_RECONNECT_MAX_DELAY, createUseFeatureAccess, executionsKeys, observabilityKeys, scheduleKeys, sessionsKeys, sortData, useActivities, useActivityTrend, useArchiveSession, useBatchDelete, useBulkDeleteExecutions, useBusinessImpact, useCancelExecution, useCancelSchedule, useCostBreakdown, useCostByModel, useCostSummary, useCostTrends, useCreateSchedule, useCreateSession, useDashboardMetrics, useDeleteExecution, useDeleteSchedule, useDeleteSession, useErrorAnalysis, useErrorDetail, useErrorDetails, useErrorDistribution, useErrorNotification, useErrorTrends, useExecuteAsync, useExecution, useExecutionHealth, useExecutionLogs, useExecutions, useGetExecutionHistory, useGetSchedule, useListSchedules, useMarkAllAsRead, useMarkAsRead, useNotificationCount, useNotifications, usePaginationState, usePauseSchedule, useResolveAllErrors, useResolveError, useResolveErrorsByExecution, useResourceDefinition, useResources, useResumeSchedule, useRetryExecution, useSSEConnection, useSession, useSessionExecution, useSessionExecutions, useSessionMessages, useSessionWebSocket, useSessions, useSortedData, useSuccessNotification, useTableSelection, useTableSort, useTopFailingResources, useUnresolveError, useUpdateAnchor, useUpdateSchedule, useWarningNotification };
+export type { ActivityTrendResponse, BulkDeleteExecutionsParams, BulkDeleteExecutionsResult, BusinessImpactMetrics, CancelExecutionParams, CancelExecutionResult, ChatMessage, CostBreakdownItem, CreateScheduleInput, CreateSessionResponse, DeleteExecutionParams, ErrorDistributionItem, ErrorDistributionParams, ErrorFilters, ErrorTrendsParams, ExecuteAsyncParams, ExecuteAsyncResult, ExecutionHistoryItem, ExecutionHistoryResponse, ExecutionLogsPageResponse, FailingResource, GetMessagesResponse, ListActivitiesResponse, ListSchedulesFilters, ListSchedulesResponse, MessageEvent, MessageType, ResourcesResponse, RetryExecutionParams, SessionDTO, SessionExecution, SessionExecutionsResponse, SessionListItem, SessionTokenUsage, SortDirection, SortState, TaskSchedule, TopFailingResourcesParams, UpdateScheduleInput, UseActivitiesParams, UseActivityTrendParams, UseExecutionHealthParams, UseExecutionLogsParams, UseSSEConnectionOptions, WebSocketState };