@contractspec/module.ai-chat 4.0.2 → 4.1.0

package/dist/presentation/hooks/useChat.d.ts

@@ -1,5 +1,13 @@
 import type { ChatAttachment, ChatConversation, ChatMessage } from '../../core/message-types';
-import { type ProviderMode, type ProviderName } from '@contractspec/lib.ai-providers';
+import type { ConversationStore } from '../../core/conversation-store';
+import type { ThinkingLevel } from '../../core/thinking-levels';
+import { type ModelSelector, type ProviderMode, type ProviderName } from '@contractspec/lib.ai-providers';
+import type { WorkflowComposer } from '@contractspec/lib.workflow-composer';
+import type { WorkflowSpec } from '@contractspec/lib.contracts-spec/workflow';
+import type { ContractsContextConfig } from '../../core/contracts-context';
+import type { ResolvedSurfacePlan } from '@contractspec/lib.surface-runtime/runtime/resolve-bundle';
+import type { SurfacePatchProposal } from '@contractspec/lib.surface-runtime/spec/types';
+import type { McpClientConfig } from '@contractspec/lib.ai-agent/tools/mcp-client';
 /** Tool definition for planner integration (reserved for bundle spec 07_ai_native_chat). */
 export interface UseChatToolDef {
     name: string;
@@ -24,6 +32,8 @@ export interface UseChatOptions {
     proxyUrl?: string;
     /** Initial conversation ID to resume */
     conversationId?: string;
+    /** Optional store for persistence (enables history, fork, edit) */
+    store?: ConversationStore;
     /** System prompt override */
     systemPrompt?: string;
     /** Enable streaming */
@@ -44,6 +54,28 @@ export interface UseChatOptions {
      * Use requireApproval: true for tools that need user confirmation.
      */
     tools?: UseChatToolDef[];
+    /** Thinking level: instant, thinking, extra_thinking, max. Maps to provider reasoning options. */
+    thinkingLevel?: ThinkingLevel;
+    /** Workflow creation tools: base workflows and optional composer */
+    workflowToolsConfig?: {
+        baseWorkflows: WorkflowSpec[];
+        composer?: WorkflowComposer;
+    };
+    /** Optional model selector for dynamic model selection by task dimension */
+    modelSelector?: ModelSelector;
+    /** Contracts-spec context: agent, data-views, operations, forms, presentations */
+    contractsContext?: ContractsContextConfig;
+    /** Surface plan config: enables propose-patch tool when used in surface-runtime */
+    surfacePlanConfig?: {
+        plan: ResolvedSurfacePlan;
+        onPatchProposal?: (proposal: SurfacePatchProposal) => void;
+    };
+    /** MCP server configs: tools from these servers are merged into chat tools */
+    mcpServers?: McpClientConfig[];
+    /** Agent mode: use provided agent instead of ChatService for generation */
+    agentMode?: {
+        agent: import('../../core/agent-adapter').ChatAgentAdapter;
+    };
 }
 /**
  * Return type for useChat hook
@@ -58,7 +90,9 @@ export interface UseChatReturn {
     /** Current error */
     error: Error | null;
     /** Send a message */
-    sendMessage: (content: string, attachments?: ChatAttachment[]) => Promise<void>;
+    sendMessage: (content: string, attachments?: ChatAttachment[], options?: {
+        skipUserAppend?: boolean;
+    }) => Promise<void>;
     /** Clear conversation and start fresh */
     clearConversation: () => void;
     /** Set conversation ID to resume */
@@ -67,6 +101,14 @@ export interface UseChatReturn {
     regenerate: () => Promise<void>;
     /** Stop current generation */
     stop: () => void;
+    /** Start a new conversation (alias for clearConversation) */
+    createNewConversation: () => void;
+    /** Edit a user message and regenerate from that point */
+    editMessage: (messageId: string, newContent: string) => Promise<void>;
+    /** Fork current conversation, optionally up to a message; returns new conversation ID */
+    forkConversation: (upToMessageId?: string) => Promise<string | null>;
+    /** Update conversation metadata (title, projectId, tags) */
+    updateConversation: (updates: Parameters<ConversationStore['update']>[1]) => Promise<ChatConversation | null>;
     /**
      * Add tool approval response when tools have requireApproval.
      * Required when stream pauses for approval. Full support requires server route.

package/dist/presentation/hooks/useConversations.d.ts

@@ -0,0 +1,18 @@
+import type { ChatConversation } from '../../core/message-types';
+import type { ConversationStore } from '../../core/conversation-store';
+export interface UseConversationsOptions {
+    store: ConversationStore;
+    projectId?: string;
+    tags?: string[];
+    limit?: number;
+}
+export interface UseConversationsReturn {
+    conversations: ChatConversation[];
+    isLoading: boolean;
+    refresh: () => Promise<void>;
+    deleteConversation: (id: string) => Promise<boolean>;
+}
+/**
+ * Hook for listing and managing conversations from a store
+ */
+export declare function useConversations(options: UseConversationsOptions): UseConversationsReturn;

package/dist/presentation/hooks/useMessageSelection.d.ts

@@ -0,0 +1,13 @@
+export interface UseMessageSelectionReturn {
+    selectedIds: Set<string>;
+    toggle: (id: string) => void;
+    selectAll: () => void;
+    clearSelection: () => void;
+    isSelected: (id: string) => boolean;
+    selectedCount: number;
+}
+/**
+ * Hook for managing message selection state.
+ * Selection persists when messages change; ids of non-existent messages are removed.
+ */
+export declare function useMessageSelection(messageIds: string[]): UseMessageSelectionReturn;