@contractspec/module.ai-chat 4.0.3 → 4.1.0

package/dist/core/local-storage-conversation-store.d.ts

@@ -0,0 +1,33 @@
+/**
+ * LocalStorage-backed conversation store for web persistence
+ */
+import type { ChatConversation, ChatMessage, ConversationStatus } from './message-types';
+import type { ConversationStore } from './conversation-store';
+/**
+ * Conversation store backed by localStorage.
+ * Persists conversations across page reloads.
+ */
+export declare class LocalStorageConversationStore implements ConversationStore {
+    private readonly key;
+    private cache;
+    constructor(storageKey?: string);
+    private getMap;
+    private persist;
+    get(conversationId: string): Promise<ChatConversation | null>;
+    create(conversation: Omit<ChatConversation, 'id' | 'createdAt' | 'updatedAt'>): Promise<ChatConversation>;
+    update(conversationId: string, updates: Partial<Pick<ChatConversation, 'title' | 'status' | 'summary' | 'metadata' | 'projectId' | 'projectName' | 'tags'>>): Promise<ChatConversation | null>;
+    appendMessage(conversationId: string, message: Omit<ChatMessage, 'id' | 'conversationId' | 'createdAt' | 'updatedAt'>): Promise<ChatMessage>;
+    updateMessage(conversationId: string, messageId: string, updates: Partial<ChatMessage>): Promise<ChatMessage | null>;
+    delete(conversationId: string): Promise<boolean>;
+    list(options?: {
+        status?: ConversationStatus;
+        projectId?: string;
+        tags?: string[];
+        limit?: number;
+        offset?: number;
+    }): Promise<ChatConversation[]>;
+    fork(conversationId: string, upToMessageId?: string): Promise<ChatConversation>;
+    truncateAfter(conversationId: string, messageId: string): Promise<ChatConversation | null>;
+    search(query: string, limit?: number): Promise<ChatConversation[]>;
+}
+export declare function createLocalStorageConversationStore(storageKey?: string): ConversationStore;

package/dist/core/message-types.d.ts

@@ -98,6 +98,10 @@ export interface ChatConversation {
     contextFiles?: string[];
     messages: ChatMessage[];
     summary?: string;
+    projectId?: string;
+    projectName?: string;
+    tags?: string[];
+    forkedFromId?: string;
     metadata?: Record<string, unknown>;
 }
 /**
@@ -111,6 +115,8 @@ export interface SendMessageOptions {
     maxTokens?: number;
     temperature?: number;
     stream?: boolean;
+    /** When true, do not append user message (for edit/regenerate flow) */
+    skipUserAppend?: boolean;
 }
 /**
  * Streaming chunk from AI response (maps from AI SDK fullStream parts)

package/dist/core/surface-planner-tools.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Surface planner tools for ai-chat.
+ * Enables the model to propose surface patches when used in surface-runtime contexts.
+ * Requires @contractspec/lib.surface-runtime (optional peer).
+ */
+import { type ToolSet } from 'ai';
+import type { ResolvedSurfacePlan } from '@contractspec/lib.surface-runtime/runtime/resolve-bundle';
+import { type PatchProposalConstraints } from '@contractspec/lib.surface-runtime/spec/validate-surface-patch';
+import type { SurfacePatchProposal } from '@contractspec/lib.surface-runtime/spec/types';
+export interface SurfacePlannerToolsConfig {
+    plan: ResolvedSurfacePlan;
+    /** Optional; derived from plan layout when omitted */
+    constraints?: PatchProposalConstraints;
+    /** Called when a valid proposal is produced; host app stores in plan.ai.proposals */
+    onPatchProposal?: (proposal: SurfacePatchProposal) => void;
+}
+/**
+ * Create AI SDK tools for surface patch proposals.
+ * Tool: propose-patch
+ */
+export declare function createSurfacePlannerTools(config: SurfacePlannerToolsConfig): ToolSet;
+/** Build PlannerPromptInput from ResolvedSurfacePlan for system prompt. */
+export declare function buildPlannerPromptInput(plan: ResolvedSurfacePlan): import('@contractspec/lib.surface-runtime/runtime/planner-prompt').PlannerPromptInput;

package/dist/core/surface-planner-tools.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/thinking-levels.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Thinking level abstraction for AI chat.
+ * Maps to provider-specific reasoning options (Anthropic budgetTokens, OpenAI reasoningEffort).
+ */
+import type { ProviderName } from '@contractspec/lib.ai-providers';
+/**
+ * Thinking level: controls how much internal reasoning the model performs.
+ */
+export type ThinkingLevel = 'instant' | 'thinking' | 'extra_thinking' | 'max';
+/**
+ * Human-readable labels for UI
+ */
+export declare const THINKING_LEVEL_LABELS: Record<ThinkingLevel, string>;
+/**
+ * Descriptions for tooltips
+ */
+export declare const THINKING_LEVEL_DESCRIPTIONS: Record<ThinkingLevel, string>;
+/**
+ * Provider options for streamText/generateText (AI SDK).
+ * Keys match provider names; only the active provider's options are used.
+ */
+export interface ProviderOptionsMap {
+    anthropic?: {
+        thinking?: {
+            type: 'enabled';
+            budgetTokens: number;
+        };
+        effort?: 'low' | 'medium' | 'high';
+    };
+    openai?: {
+        reasoningEffort?: 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
+    };
+}
+/**
+ * Get provider-specific options for the given thinking level and provider.
+ * Returns options suitable for AI SDK streamText/generateText providerOptions.
+ */
+export declare function getProviderOptions(level: ThinkingLevel | undefined, providerName: ProviderName): ProviderOptionsMap;

package/dist/core/thinking-levels.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/workflow-tools.d.ts

@@ -0,0 +1,18 @@
+/**
+ * AI SDK tools for workflow creation via chat.
+ * Leverages @contractspec/lib.workflow-composer for validation and composition.
+ */
+import { type ToolSet } from 'ai';
+import type { WorkflowSpec } from '@contractspec/lib.contracts-spec/workflow';
+import { WorkflowComposer } from '@contractspec/lib.workflow-composer';
+export interface WorkflowToolsConfig {
+    /** Base workflows keyed by meta.key for compose and validate */
+    baseWorkflows: WorkflowSpec[];
+    /** Optional pre-configured composer with extensions; if not provided, a fresh one is used per compose */
+    composer?: WorkflowComposer;
+}
+/**
+ * Create AI SDK tools for workflow creation.
+ * Tools: create_workflow_extension, compose_workflow, generate_workflow_spec_code.
+ */
+export declare function createWorkflowTools(config: WorkflowToolsConfig): ToolSet;

package/dist/core/workflow-tools.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -11,5 +11,7 @@ export * from './schema';
 export * from './ai-chat.operations';
 export * from './events';
 export * from './ai-chat.feature';
-export { ChatContainer, ChatMessage as ChatMessageComponent, ChatInput, } from './presentation/components';
-export { useChat, useProviders } from './presentation/hooks';
+export { ChatContainer, ChatMessage as ChatMessageComponent, ChatInput, ChatExportToolbar, ChatWithExport, ChatSidebar, ChatWithSidebar, ThinkingLevelPicker, } from './presentation/components';
+export { useChat, useProviders, useMessageSelection, useConversations, } from './presentation/hooks';
+export { createAiSdkBundleAdapter, type CreateAiSdkBundleAdapterDeps, } from './adapters';
+export { createChatAgentAdapter, type ChatAgentAdapter, } from './core/agent-adapter';