@greatapps/greatagents-ui 0.3.3 → 0.3.5

package/dist/index.d.ts

@@ -5,6 +5,34 @@ import { DndContextProps, UniqueIdentifier, DragEndEvent, DragOverlay } from '@d
 import { SortableContextProps } from '@dnd-kit/sortable';
 import * as React$1 from 'react';
 
+interface CapabilityOperation {
+    slug: string;
+    label: string;
+    description: string;
+}
+interface CapabilityModule {
+    slug: string;
+    label: string;
+    description: string;
+    operations: string[];
+}
+interface CapabilityCategory {
+    slug: string;
+    label: string;
+    modules: CapabilityModule[];
+}
+interface CapabilitiesResponse {
+    product: string | null;
+    categories: CapabilityCategory[];
+}
+interface AgentCapability {
+    module: string;
+    operations: string[];
+}
+interface AgentCapabilitiesPayload {
+    capabilities: AgentCapability[];
+}
+
 interface ApiResponse<T = unknown> {
     status: 0 | 1;
     message?: string;
@@ -206,6 +234,9 @@ declare function createGagentsClient(config: GagentsClientConfig): {
         end_time: string;
     }) => Promise<ApiResponse<AvailabilityResult>>;
     disconnectCalendar: (idAccount: number, externalReference: string, provider?: string) => Promise<ApiResponse<void>>;
+    getCapabilities: (idAccount: number) => Promise<ApiResponse<CapabilitiesResponse>>;
+    getAgentCapabilities: (idAccount: number, idAgent: number) => Promise<ApiResponse<AgentCapability[]>>;
+    updateAgentCapabilities: (idAccount: number, idAgent: number, body: AgentCapabilitiesPayload) => Promise<ApiResponse<AgentCapability[]>>;
 };
 type GagentsClient = ReturnType<typeof createGagentsClient>;
 
@@ -265,6 +296,9 @@ declare function useGagentsClient(config: GagentsHookConfig): {
         end_time: string;
     }) => Promise<ApiResponse<AvailabilityResult>>;
     disconnectCalendar: (idAccount: number, externalReference: string, provider?: string) => Promise<ApiResponse<void>>;
+    getCapabilities: (idAccount: number) => Promise<ApiResponse<CapabilitiesResponse>>;
+    getAgentCapabilities: (idAccount: number, idAgent: number) => Promise<ApiResponse<AgentCapability[]>>;
+    updateAgentCapabilities: (idAccount: number, idAgent: number, body: AgentCapabilitiesPayload) => Promise<ApiResponse<AgentCapability[]>>;
 };
 
 declare function useAgents(config: GagentsHookConfig, params?: Record<string, string>): _tanstack_react_query.UseQueryResult<{
@@ -405,6 +439,50 @@ declare function useGagentsContacts(config: GagentsHookConfig, params?: Record<s
     total: number;
 }, Error>;
 
+declare function useCapabilities(config: GagentsHookConfig): _tanstack_react_query.UseQueryResult<CapabilitiesResponse, Error>;
+declare function useAgentCapabilities(config: GagentsHookConfig, agentId: number | null): _tanstack_react_query.UseQueryResult<AgentCapability[], Error>;
+declare function useUpdateAgentCapabilities(config: GagentsHookConfig): _tanstack_react_query.UseMutationResult<ApiResponse<AgentCapability[]>, Error, {
+    agentId: number;
+    payload: AgentCapabilitiesPayload;
+}, unknown>;
+
+type IntegrationAuthType = "oauth2" | "api_key" | "none";
+type IntegrationStatus = "available" | "coming_soon";
+interface IntegrationDefinition {
+    slug: string;
+    name: string;
+    description: string;
+    icon: string;
+    authType: IntegrationAuthType;
+    status: IntegrationStatus;
+}
+declare const INTEGRATIONS_REGISTRY: IntegrationDefinition[];
+
+type IntegrationCardState = "available" | "connected" | "expired" | "coming_soon";
+interface IntegrationCardData {
+    /** Static definition from registry */
+    definition: IntegrationDefinition;
+    /** Resolved visual state */
+    state: IntegrationCardState;
+    /** Matching credential if one exists */
+    credential: ToolCredential | null;
+    /** Matching tool record if one exists */
+    tool: Tool | null;
+    /** How many agents share this credential */
+    sharedByAgentsCount: number;
+    /** Whether this agent has a linked agent_tool for this integration */
+    linkedToAgent: boolean;
+}
+/**
+ * Cross-references the static integrations registry with live data
+ * (tools, tool_credentials, agent_tools) to produce card state for each
+ * integration entry.
+ */
+declare function useIntegrationState(config: GagentsHookConfig, agentId: number | null): {
+    cards: IntegrationCardData[];
+    isLoading: boolean;
+};
+
 declare function AgentsTable({ config, onNavigateToAgent }: {
     config: GagentsHookConfig;
     onNavigateToAgent?: (agentId: number) => void;
@@ -427,12 +505,58 @@ interface AgentEditFormProps {
 }
 declare function AgentEditForm({ config, agent, idAccount, open, onOpenChange }: AgentEditFormProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Types for the Integration Wizard flow.
+ *
+ * The wizard uses the base IntegrationDefinition from the integrations registry
+ * and extends it with wizard-specific metadata via WizardIntegrationMeta.
+ */
+
+interface IntegrationCapability {
+    label: string;
+    description?: string;
+}
+interface WizardIntegrationMeta {
+    /** Icon as React node for the wizard header */
+    icon?: React.ReactNode;
+    /** Provider label for OAuth button (e.g. "Google") */
+    providerLabel?: string;
+    /** What this integration can do */
+    capabilities: IntegrationCapability[];
+    /** Required permissions / prerequisites */
+    requirements: string[];
+    /** Whether this integration has a config step */
+    hasConfigStep: boolean;
+}
+type WizardStep = "info" | "credentials" | "config" | "confirm";
+type OAuthStatus = "idle" | "waiting" | "success" | "error";
+interface OAuthResult {
+    success: boolean;
+    email?: string;
+    error?: string;
+    credentialId?: number;
+}
+
+interface ConfigOption {
+    id: string;
+    label: string;
+    description?: string;
+}
+
 interface AgentTabsProps {
     agent: Agent;
     config: GagentsHookConfig;
     renderChatLink?: (inboxId: number) => React.ReactNode;
-}
-declare function AgentTabs({ agent, config, renderChatLink }: AgentTabsProps): react_jsx_runtime.JSX.Element;
+    /** Required for the Capacidades tab — gagents API URL for OAuth flows and advanced features. Falls back to config.baseUrl. */
+    gagentsApiUrl?: string;
+    /** Resolve wizard metadata for a given integration card. */
+    resolveWizardMeta?: (card: IntegrationCardData) => WizardIntegrationMeta;
+    /** Callback to load config options after OAuth completes. */
+    loadConfigOptions?: (credentialId: number) => Promise<ConfigOption[]>;
+    /** Called after wizard completes successfully. */
+    onWizardComplete?: () => void;
+}
+declare function AgentTabs({ agent, config, renderChatLink, gagentsApiUrl, resolveWizardMeta, loadConfigOptions, onWizardComplete, }: AgentTabsProps): react_jsx_runtime.JSX.Element;
 
 interface AgentPromptEditorProps {
     config: GagentsHookConfig;
@@ -547,6 +671,63 @@ interface ConversationViewProps {
 }
 declare function ConversationView({ conversationId, onClose, contactsMap, config, renderChatLink, }: ConversationViewProps): react_jsx_runtime.JSX.Element;
 
+interface IntegrationCardProps {
+    card: IntegrationCardData;
+    onConnect: (card: IntegrationCardData) => void;
+}
+declare function IntegrationCard({ card, onConnect }: IntegrationCardProps): react_jsx_runtime.JSX.Element;
+
+interface IntegrationsTabProps {
+    config: GagentsHookConfig;
+    agentId: number | null;
+    /** Called when user clicks a card action (connect / configure / reconnect).
+     *  The consuming app wires this to the wizard (Story 18.9). */
+    onConnect: (card: IntegrationCardData) => void;
+}
+declare function IntegrationsTab({ config, agentId, onConnect, }: IntegrationsTabProps): react_jsx_runtime.JSX.Element;
+
+interface CapabilitiesTabProps {
+    config: GagentsHookConfig;
+    agentId: number;
+}
+declare function CapabilitiesTab({ config, agentId }: CapabilitiesTabProps): react_jsx_runtime.JSX.Element;
+
+interface AdvancedTabProps {
+    config: GagentsHookConfig;
+    agentId: number;
+    gagentsApiUrl: string;
+}
+declare function AdvancedTab({ config, agentId, gagentsApiUrl }: AdvancedTabProps): react_jsx_runtime.JSX.Element;
+
+interface IntegrationWizardProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** Base integration definition from registry */
+    integration: IntegrationDefinition;
+    /** Wizard-specific metadata (capabilities, requirements, etc.) */
+    meta: WizardIntegrationMeta;
+    agentId: string | number;
+    config: GagentsHookConfig;
+    onComplete: () => void;
+    /** gagents-r3-api base URL (used to build OAuth URLs) */
+    gagentsApiUrl: string;
+    /**
+     * Existing credential ID -- when set, the wizard opens in edit mode
+     * (step 2 shows "Reconectar" and step 3 is pre-filled).
+     */
+    existingCredentialId?: number;
+    /**
+     * Callback to load config options after OAuth completes.
+     * e.g. load Google Calendar list. Returns ConfigOption[].
+     */
+    loadConfigOptions?: (credentialId: number) => Promise<ConfigOption[]>;
+    /**
+     * Existing config value to pre-fill the config step in edit/reconnect mode.
+     */
+    existingConfigValue?: string;
+}
+declare function IntegrationWizard({ open, onOpenChange, integration, meta, agentId: _agentId, config, onComplete, gagentsApiUrl, existingCredentialId, loadConfigOptions, existingConfigValue, }: IntegrationWizardProps): react_jsx_runtime.JSX.Element;
+
 interface AgentsPageProps {
     config: GagentsHookConfig;
     onNavigateToAgent?: (agentId: number) => void;
@@ -563,6 +744,26 @@ interface AgentDetailPageProps {
 }
 declare function AgentDetailPage({ config, agentId, onBack, renderChatLink, }: AgentDetailPageProps): react_jsx_runtime.JSX.Element;
 
+interface AgentCapabilitiesPageProps {
+    config: GagentsHookConfig;
+    agentId: number;
+    gagentsApiUrl: string;
+    /**
+     * Resolve wizard metadata for a given integration card.
+     * The consuming app provides this so the wizard gets correct
+     * capabilities, requirements, and config step flag.
+     */
+    resolveWizardMeta?: (card: IntegrationCardData) => WizardIntegrationMeta;
+    /**
+     * Callback to load config options after OAuth completes
+     * (e.g. load Google Calendar list). Forwarded to IntegrationWizard.
+     */
+    loadConfigOptions?: (credentialId: number) => Promise<ConfigOption[]>;
+    /** Called after wizard completes successfully. */
+    onWizardComplete?: () => void;
+}
+declare function AgentCapabilitiesPage({ config, agentId, gagentsApiUrl, resolveWizardMeta, loadConfigOptions, onWizardComplete, }: AgentCapabilitiesPageProps): react_jsx_runtime.JSX.Element;
+
 interface ToolsPageProps {
     config: GagentsHookConfig;
     title?: string;
@@ -578,4 +779,14 @@ interface CredentialsPageProps {
 }
 declare function CredentialsPage({ config, gagentsApiUrl, title, subtitle, }: CredentialsPageProps): react_jsx_runtime.JSX.Element;
 
-export { type Agent, AgentConversationsPanel, AgentConversationsTable, AgentDetailPage, type AgentDetailPageProps, AgentEditForm, AgentFormDialog, AgentObjectivesList, AgentPromptEditor, AgentTabs, type AgentTool, AgentToolsList, AgentsPage, type AgentsPageProps, AgentsTable, type ApiResponse, type AvailabilityConflict, type AvailabilityResult, type CalendarStatus, type ContactUser, type Conversation, ConversationView, CredentialsPage, type CredentialsPageProps, type GagentsClient, type GagentsClientConfig, type GagentsContact, type GagentsHookConfig, type Objective, type PromptVersion, Sortable, SortableContent, SortableItem, SortableItemHandle, SortableOverlay, type Tool, type ToolCredential, ToolCredentialsForm, ToolFormDialog, ToolsPage, type ToolsPageProps, ToolsTable, cn, createGagentsClient, useAddAgentTool, useAgent, useAgentConversations, useAgentTools, useAgents, useContactUsers, useConversation, useConversations, useCreateAgent, useCreateObjective, useCreateTool, useCreateToolCredential, useDeleteAgent, useDeleteObjective, useDeleteTool, useDeleteToolCredential, useGagentsClient, useGagentsContacts, useObjectives, usePromptVersions, useRemoveAgentTool, useTool, useToolCredentials, useTools, useUpdateAgent, useUpdateAgentTool, useUpdateObjective, useUpdateTool, useUpdateToolCredential };
+interface IntegrationsManagementPageProps {
+    config: GagentsHookConfig;
+    gagentsApiUrl: string;
+    /** Called when user clicks connect/reconnect on an integration card. */
+    onConnect?: (card: IntegrationCardData) => void;
+    title?: string;
+    subtitle?: string;
+}
+declare function IntegrationsManagementPage({ config, gagentsApiUrl, onConnect, title, subtitle, }: IntegrationsManagementPageProps): react_jsx_runtime.JSX.Element;
+
+export { AdvancedTab, type AdvancedTabProps, type Agent, AgentCapabilitiesPage, type AgentCapabilitiesPageProps, type AgentCapabilitiesPayload, type AgentCapability, AgentConversationsPanel, AgentConversationsTable, AgentDetailPage, type AgentDetailPageProps, AgentEditForm, AgentFormDialog, AgentObjectivesList, AgentPromptEditor, AgentTabs, type AgentTool, AgentToolsList, AgentsPage, type AgentsPageProps, AgentsTable, type ApiResponse, type AvailabilityConflict, type AvailabilityResult, type CalendarStatus, type CapabilitiesResponse, CapabilitiesTab, type CapabilitiesTabProps, type CapabilityCategory, type CapabilityModule, type CapabilityOperation, type ConfigOption, type ContactUser, type Conversation, ConversationView, CredentialsPage, type CredentialsPageProps, type GagentsClient, type GagentsClientConfig, type GagentsContact, type GagentsHookConfig, INTEGRATIONS_REGISTRY, type IntegrationAuthType, type IntegrationCapability, IntegrationCard, type IntegrationCardData, type IntegrationCardProps, type IntegrationCardState, type IntegrationDefinition, type IntegrationStatus, IntegrationWizard, type IntegrationWizardProps, IntegrationsManagementPage, type IntegrationsManagementPageProps, IntegrationsTab, type IntegrationsTabProps, type OAuthResult, type OAuthStatus, type Objective, type PromptVersion, Sortable, SortableContent, SortableItem, SortableItemHandle, SortableOverlay, type Tool, type ToolCredential, ToolCredentialsForm, ToolFormDialog, ToolsPage, type ToolsPageProps, ToolsTable, type WizardIntegrationMeta, type WizardStep, cn, createGagentsClient, useAddAgentTool, useAgent, useAgentCapabilities, useAgentConversations, useAgentTools, useAgents, useCapabilities, useContactUsers, useConversation, useConversations, useCreateAgent, useCreateObjective, useCreateTool, useCreateToolCredential, useDeleteAgent, useDeleteObjective, useDeleteTool, useDeleteToolCredential, useGagentsClient, useGagentsContacts, useIntegrationState, useObjectives, usePromptVersions, useRemoveAgentTool, useTool, useToolCredentials, useTools, useUpdateAgent, useUpdateAgentCapabilities, useUpdateAgentTool, useUpdateObjective, useUpdateTool, useUpdateToolCredential };