@cntyclub/agent-react 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -1,547 +1,10 @@
-import * as React from 'react';
-
-/**
- * This file was auto-generated by openapi-typescript.
- * Do not make direct changes to the file.
- */
-interface paths {
-    "/agent-mode/approvals/{call_id}/resolve/": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Resolve a pending agent action
-         * @description Approve or decline a pending write-tool call.
-         */
-        post: operations["agent_approval_resolve"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/agent-mode/chat/": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Chat with an agent
-         * @description Sends a user message to the agent identified by client_id. Read-only MCP tools run automatically; write tools come back as pending approvals the user must resolve.
-         */
-        post: operations["agent_chat_send"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/agent-mode/config/": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get agent widget config
-         * @description Widget bootstrap: safe agent display config for the resolved client_id.
-         */
-        get: operations["agent_config_get"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/agent-mode/conversations/": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * List my conversations
-         * @description List the calling user's conversations with an agent.
-         */
-        get: operations["agent_conversations_list"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/agent-mode/conversations/{conversation_id}/": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get conversation messages
-         * @description Fetch or delete one of the calling user's conversations.
-         */
-        get: operations["agent_conversation_get"];
-        put?: never;
-        post?: never;
-        /**
-         * Delete a conversation
-         * @description Fetch or delete one of the calling user's conversations.
-         */
-        delete: operations["agent_conversation_delete"];
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-}
-interface components {
-    schemas: {
-        /** @description One chat message as returned by Agent Mode endpoints (wire format). */
-        AgentChatMessage: {
-            /** Format: uuid */
-            id: string;
-            /**
-             * @description * `user` - user
-             *     * `assistant` - assistant
-             *     * `tool` - tool
-             * @enum {string}
-             */
-            role: "user" | "assistant" | "tool";
-            content: string;
-            /** Format: date-time */
-            created_at: string;
-            /** @description Structured UI blocks. Table blocks: {type:'table', tool_name, columns[], rows[], row_count, truncated?, pagination?}. */
-            blocks?: {
-                [key: string]: unknown;
-            }[];
-            /** @description Assistant messages only: tools the assistant requested ({id, name, arguments}). */
-            tool_calls?: {
-                [key: string]: unknown;
-            }[];
-            tool_name?: string;
-            tool_call_id?: string;
-        };
-        /** @description Response of the chat and approval-resolve endpoints. */
-        AgentChatResponse: {
-            /**
-             * @description * `success` - success
-             *     * `error` - error
-             * @enum {string}
-             */
-            status: "success" | "error";
-            /** @description Human-readable error detail when status=error. */
-            message?: string;
-            /** Format: uuid */
-            conversation_id?: string;
-            /** @description New messages created by this call, in order. */
-            messages?: components["schemas"]["AgentChatMessage"][];
-            pending_approvals?: components["schemas"]["PendingApproval"][];
-        };
-        /** @description Response of GET /agent-mode/conversations/<id>/. */
-        AgentConversationDetailResponse: {
-            conversation: components["schemas"]["ConversationList"];
-            messages: components["schemas"]["AgentChatMessage"][];
-            pending_approvals: components["schemas"]["PendingApproval"][];
-        };
-        /** @description Response of GET /agent-mode/conversations/. */
-        AgentConversationsResponse: {
-            conversations: components["schemas"]["ConversationList"][];
-        };
-        /** @description Widget bootstrap config — safe, non-sensitive fields only. */
-        AgentPublicConfig: {
-            name: string;
-            description: string;
-            has_mcp: boolean;
-            is_public: boolean;
-        };
-        /** @description Input for POST /agent-mode/approvals/<id>/resolve/. */
-        ApprovalRequestRequest: {
-            client_id: string;
-            approve: boolean;
-        };
-        /** @description Input for POST /agent-mode/chat/. */
-        ChatRequestRequest: {
-            client_id: string;
-            message: string;
-            /** Format: uuid */
-            conversation_id?: string | null;
-        };
-        ConversationList: {
-            /** Format: uuid */
-            readonly id?: string;
-            /** @description Derived from the first user message. */
-            title?: string;
-            /** Format: date-time */
-            readonly created_at?: string;
-            /** Format: date-time */
-            readonly updated_at?: string;
-        };
-        /** @description A write-tool call waiting for the user's explicit approval. */
-        PendingApproval: {
-            /** Format: uuid */
-            id: string;
-            tool_name: string;
-            /** @description Stored arguments that will be executed verbatim on approval. */
-            arguments: {
-                [key: string]: unknown;
-            };
-            /** Format: date-time */
-            created_at: string;
-        };
-    };
-    responses: never;
-    parameters: never;
-    requestBodies: never;
-    headers: never;
-    pathItems: never;
-}
-interface operations {
-    agent_approval_resolve: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                call_id: string;
-            };
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["ApprovalRequestRequest"];
-                "application/x-www-form-urlencoded": components["schemas"]["ApprovalRequestRequest"];
-                "multipart/form-data": components["schemas"]["ApprovalRequestRequest"];
-            };
-        };
-        responses: {
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["AgentChatResponse"];
-                };
-            };
-        };
-    };
-    agent_chat_send: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["ChatRequestRequest"];
-                "application/x-www-form-urlencoded": components["schemas"]["ChatRequestRequest"];
-                "multipart/form-data": components["schemas"]["ChatRequestRequest"];
-            };
-        };
-        responses: {
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["AgentChatResponse"];
-                };
-            };
-        };
-    };
-    agent_config_get: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["AgentPublicConfig"];
-                };
-            };
-        };
-    };
-    agent_conversations_list: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["AgentConversationsResponse"];
-                };
-            };
-        };
-    };
-    agent_conversation_get: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                conversation_id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["AgentConversationDetailResponse"];
-                };
-            };
-        };
-    };
-    agent_conversation_delete: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                conversation_id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description No response body */
-            204: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-        };
-    };
-}
-
-/**
- * All wire types derive from the generated OpenAPI schema (src/api/schema.ts,
- * generated from api-spec/agent-mode-api.yaml — the backend's
- * /agent-mode/schema/ document). Regenerate with `pnpm gen:api` after updating
- * the spec; see the README for the full update workflow.
- */
-type AgentModeSchemas = components["schemas"];
-/** A structured UI block attached to a message (currently: result tables). */
-interface TableBlock {
-    type: "table";
-    tool_name: string;
-    columns: string[];
-    rows: Record<string, unknown>[];
-    row_count: number;
-    truncated?: boolean;
-    pagination?: Record<string, unknown>;
-}
-type MessageBlock = TableBlock;
-interface ToolCallInfo {
-    id?: string;
-    name?: string;
-    arguments?: Record<string, unknown>;
-}
-/**
- * One chat message. Wire shape from the schema; `blocks`/`tool_calls` are
- * JSON fields on the wire, narrowed here to their documented structures.
- */
-interface AgentMessage extends Omit<AgentModeSchemas["AgentChatMessage"], "blocks" | "tool_calls"> {
-    blocks?: MessageBlock[];
-    tool_calls?: ToolCallInfo[];
-}
-type PendingApproval = AgentModeSchemas["PendingApproval"];
-type ConversationSummary = Required<AgentModeSchemas["ConversationList"]>;
-type AgentPublicConfig = AgentModeSchemas["AgentPublicConfig"];
-/** Response of the chat and approval-resolve endpoints. */
-interface ChatResponse extends Omit<AgentModeSchemas["AgentChatResponse"], "messages"> {
-    messages?: AgentMessage[];
-}
-type ChatRequest = AgentModeSchemas["ChatRequestRequest"];
-type ApprovalRequest = AgentModeSchemas["ApprovalRequestRequest"];
-/** Maps MCP tools to a page in the host app so the agent can navigate alongside chat. */
-interface AgentPageMapping {
-    /** MCP tool names whose execution relates to this page. */
-    tools: string[];
-    /** Host-app route (path) to navigate to, e.g. "/dashboard/target-companies". */
-    route: string;
-    /** Human title shown in navigation hints. */
-    title: string;
-    /**
-     * Optional builder for dynamic routes: receives the tool arguments and
-     * returns the concrete path (e.g. `/dashboard/company/${args.id}`).
-     * Return null to skip navigation for that call.
-     */
-    buildRoute?: (args: Record<string, unknown>) => string | null;
-}
-interface AgentConfig {
-    /** The Agent Mode client ID from the office panel (identifies the agent only). */
-    clientId: string;
-    /** Country Club backend base URL, e.g. https://api.country.club */
-    apiBaseUrl: string;
-    /** Returns the logged-in user's Country Club JWT (or null when logged out). */
-    getAccessToken: () => string | null | Promise<string | null>;
-    /** Display name override; falls back to the backend-configured agent name. */
-    agentName?: string;
-    /** Short line under the title in the panel header. */
-    tagline?: string;
-    /** Suggested prompts shown on the empty state. */
-    suggestions?: string[];
-    /** Navigate the host app (e.g. Next router push). Enables page-follow in popup mode. */
-    navigate?: (path: string) => void;
-    /** Tool → page mappings used for page-follow navigation and hints. */
-    pages?: AgentPageMapping[];
-    /** Widget appearance tweaks. All styling comes from the host's UI-kit theme tokens. */
-    appearance?: {
-        /** Floating button position. Default: "bottom-right". */
-        position?: "bottom-right" | "bottom-left";
-        /** Desktop popup panel size. Defaults: 400 x 640. */
-        panelWidth?: number;
-        panelHeight?: number;
-        /** Hide the floating button (render the panel through your own trigger). */
-        hideLauncher?: boolean;
-    };
-}
-
-declare class AgentApiError extends Error {
-    status: number;
-    constructor(message: string, status: number);
-}
-/**
- * Thin fetch client for the Country Club Agent Mode API.
- *
- * Every request carries the agent client_id (query param — also used by the
- * backend's per-agent CORS middleware, including on preflights) and the
- * logged-in user's bearer token.
- */
-declare class AgentApiClient {
-    private config;
-    constructor(config: AgentConfig);
-    private request;
-    getConfig(): Promise<AgentPublicConfig>;
-    sendMessage(message: string, conversationId?: string | null): Promise<ChatResponse>;
-    resolveApproval(callId: string, approve: boolean): Promise<ChatResponse>;
-    listConversations(): Promise<{
-        conversations: ConversationSummary[];
-    }>;
-    getConversation(conversationId: string): Promise<{
-        conversation: ConversationSummary;
-        messages: ChatResponse["messages"];
-        pending_approvals: ChatResponse["pending_approvals"];
-    }>;
-    deleteConversation(conversationId: string): Promise<void>;
-}
-
-interface AgentChatState {
-    agentInfo: AgentPublicConfig | null;
-    conversationId: string | null;
-    conversations: ConversationSummary[];
-    messages: AgentMessage[];
-    pendingApprovals: PendingApproval[];
-    sending: boolean;
-    resolvingApprovalId: string | null;
-    error: string | null;
-}
-interface AgentChatActions {
-    send: (text: string) => Promise<void>;
-    resolveApproval: (callId: string, approve: boolean) => Promise<void>;
-    newChat: () => void;
-    openConversation: (conversationId: string) => Promise<void>;
-    refreshConversations: () => Promise<void>;
-    deleteConversation: (conversationId: string) => Promise<void>;
-    clearError: () => void;
-}
-/**
- * Headless chat state for an Agent Mode agent: message history, sending,
- * pending write-tool approvals, and conversation management. UI-agnostic.
- */
-declare function useAgentChat(config: AgentConfig): AgentChatState & AgentChatActions;
-
-interface AgentPanelProps {
-    config: AgentConfig;
-    chat: AgentChatState & AgentChatActions;
-    /** Fullscreen "Agent Mode" is active. */
-    agentMode: boolean;
-    /** Hide the expand button (mobile is always fullscreen). */
-    canToggleAgentMode: boolean;
-    onToggleAgentMode: () => void;
-    onClose: () => void;
-    className?: string;
-}
-/**
- * The chat surface shared by the popup panel and fullscreen Agent Mode.
- * Header (title, history, new chat, expand/collapse, close) + messages + input.
- */
-declare function AgentPanel({ agentMode, canToggleAgentMode, chat, className, config, onClose, onToggleAgentMode, }: AgentPanelProps): React.JSX.Element;
-
-interface AgentWidgetProps {
-    config: AgentConfig;
-    /** Controlled open state (optional). */
-    open?: boolean;
-    onOpenChange?: (open: boolean) => void;
-}
-/**
- * The embeddable Agent Mode widget.
- *
- * - Closed: a floating round button (bottom-right by default).
- * - Open on desktop: a popup panel anchored to the button, with an
- *   "Agent Mode" button that expands to a fullscreen chat. While in the popup,
- *   the widget can navigate the host app to pages related to the tools the
- *   agent uses (via `config.pages` + `config.navigate`).
- * - Open on mobile: fullscreen from the start.
- *
- * All colors come from the host app's UI-kit theme tokens, so light/dark mode
- * follows the dashboard automatically.
- */
-declare function AgentWidget({ config, onOpenChange, open: controlledOpen }: AgentWidgetProps): React.JSX.Element;
-
-/** Renders one conversation message: user/assistant bubbles or tool results. */
-declare function MessageItem({ message }: {
-    message: AgentMessage;
-}): React.JSX.Element | null;
-
-interface ToolApprovalCardProps {
-    approval: PendingApproval;
-    resolving: boolean;
-    onResolve: (callId: string, approve: boolean) => void;
-}
-/**
- * Approval prompt for a write action the agent wants to perform. The stored
- * arguments are shown so the user knows exactly what will change; nothing runs
- * until they approve.
- */
-declare function ToolApprovalCard({ approval, onResolve, resolving }: ToolApprovalCardProps): React.JSX.Element;
-
-/**
- * Identity helper that gives host apps full type inference/checking when
- * declaring their agent config file.
- */
-declare function defineAgentConfig(config: AgentConfig): AgentConfig;
-
-export { AgentApiClient, AgentApiError, type AgentChatActions, type AgentChatState, type AgentConfig, type AgentMessage, type components as AgentModeComponents, type operations as AgentModeOperations, type paths as AgentModePaths, type AgentModeSchemas, type AgentPageMapping, AgentPanel, type AgentPanelProps, type AgentPublicConfig, AgentWidget, type AgentWidgetProps, type ApprovalRequest, type ChatRequest, type ChatResponse, type ConversationSummary, type MessageBlock, MessageItem, type PendingApproval, type TableBlock, ToolApprovalCard, type ToolApprovalCardProps, type ToolCallInfo, defineAgentConfig, useAgentChat };
+export { AgentApiClient, AgentApiError } from "./api-client";
+export { AgentPanel, type AgentPanelProps } from "./components/agent-panel";
+export { AgentWidget, type AgentWidgetProps } from "./components/agent-widget";
+export { MessageItem } from "./components/message-item";
+export { ToolApprovalCard, type ToolApprovalCardProps } from "./components/tool-approval-card";
+export { defineAgentConfig } from "./config";
+export type { AgentConfig, AgentMessage, AgentModeSchemas, AgentPageMapping, AgentPublicConfig, ApprovalRequest, ChatRequest, ChatResponse, ConversationSummary, MessageBlock, PendingApproval, TableBlock, ToolCallInfo, } from "./types";
+export type { components as AgentModeComponents, operations as AgentModeOperations, paths as AgentModePaths, } from "./api/schema";
+export { useAgentChat, type AgentChatActions, type AgentChatState, } from "./use-agent-chat";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EACV,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,UAAU,IAAI,mBAAmB,EACjC,UAAU,IAAI,mBAAmB,EACjC,KAAK,IAAI,cAAc,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC"}