skema-core 0.1.2 → 2.1.0

package/dist/server.d.ts

@@ -369,7 +369,47 @@ declare function buildDrawingToCodePrompt(input: DrawingInput): string;
  */
 declare const IMAGE_ANALYSIS_PROMPT: string;
 
+/**
+ * Execution modes:
+ * - 'direct-cli': Annotations processed instantly via CLI agents (gemini/claude CLI tools)
+ * - 'mcp': Annotations routed through an AI agent (Cursor, Claude Desktop, etc.)
+ */
+type ExecutionMode = 'direct-cli' | 'mcp';
+type ProviderName = 'gemini' | 'claude';
+
+interface DaemonConfig {
+    /** Port for WebSocket server (default: 9999) */
+    port?: number;
+    /** Working directory for file operations and AI commands */
+    cwd?: string;
+    /** Default AI provider */
+    defaultProvider?: ProviderName;
+    /** Default execution mode */
+    defaultMode?: ExecutionMode;
+}
+interface IncomingMessage {
+    id: string;
+    type: string;
+    [key: string]: unknown;
+}
+interface OutgoingMessage {
+    id?: string;
+    type: string;
+    success?: boolean;
+    error?: string;
+    [key: string]: unknown;
+}
+interface DaemonInstance {
+    port: number;
+    close: () => void;
+}
+/**
+ * Start the Skema daemon (WebSocket server)
+ */
+declare function startDaemon(config?: DaemonConfig): DaemonInstance;
+
 type AIProvider = 'gemini' | 'claude';
+type AnyProvider = 'gemini' | 'claude';
 interface AIProviderConfig {
     provider: AIProvider;
     /** Working directory for CLI commands */
@@ -381,7 +421,7 @@ interface AIStreamEvent {
     type: 'init' | 'text' | 'tool_use' | 'tool_result' | 'error' | 'done' | 'debug';
     content?: string;
     timestamp: string;
-    provider: AIProvider;
+    provider: AnyProvider;
     /** Raw event from the CLI (provider-specific) */
     raw?: unknown;
 }
@@ -411,35 +451,6 @@ declare function isProviderAvailable(provider: AIProvider): boolean;
  */
 declare function getAvailableProviders(): AIProvider[];
 
-interface DaemonConfig {
-    /** Port for WebSocket server (default: 9999) */
-    port?: number;
-    /** Working directory for file operations and AI commands */
-    cwd?: string;
-    /** Default AI provider */
-    defaultProvider?: AIProvider;
-}
-interface IncomingMessage {
-    id: string;
-    type: string;
-    [key: string]: unknown;
-}
-interface OutgoingMessage {
-    id?: string;
-    type: string;
-    success?: boolean;
-    error?: string;
-    [key: string]: unknown;
-}
-interface DaemonInstance {
-    port: number;
-    close: () => void;
-}
-/**
- * Start the Skema daemon (WebSocket server)
- */
-declare function startDaemon(config?: DaemonConfig): DaemonInstance;
-
 interface VisionAnalysisResult {
     success: boolean;
     description: string;
@@ -462,4 +473,69 @@ declare function analyzeImage(base64Image: string, config: VisionConfig): Promis
  */
 declare function isVisionAvailable(provider: AIProvider): boolean;
 
-export { type AIProvider, type AIProviderConfig, type AIRunResult, type AIStreamEvent, DELETE, type DaemonConfig, type DaemonInstance, type DetailedDomSelectionInput, type DomSelectionInput, type DrawingInput, type GeminiCLIEvent, type GeminiCLIOptions, type GestureInput, IMAGE_ANALYSIS_PROMPT, type IncomingMessage, type OutgoingMessage, POST, type ProjectContext, type VisionAnalysisResult, type VisionConfig, analyzeImage, buildDetailedDomSelectionPrompt, buildDrawingToCodePrompt, buildFastDomSelectionPrompt, buildGesturePrompt, buildPromptFromAnnotation, createGeminiCLIStream, createGeminiRouteHandler, createRevertRouteHandler, getAvailableProviders, getTrackedAnnotations, isProviderAvailable, isVisionAvailable, revertAnnotation, runAICLI, runGeminiCLI, spawnAICLI, spawnGeminiCLI, startDaemon };
+type AnnotationStatus = 'pending' | 'acknowledged' | 'resolved' | 'dismissed';
+interface StoredAnnotation {
+    /** The original Skema annotation data */
+    annotation: Annotation;
+    /** User comment describing the desired change */
+    comment: string;
+    /** Current status in the MCP workflow */
+    status: AnnotationStatus;
+    /** When it was queued */
+    createdAt: string;
+    /** When status last changed */
+    updatedAt: string;
+    /** If resolved/dismissed, who did it */
+    resolvedBy?: 'human' | 'agent';
+    /** Resolution summary (from agent) */
+    resolutionSummary?: string;
+    /** Dismissal reason (from agent) */
+    dismissalReason?: string;
+}
+type StoreListener = (event: string, annotation: StoredAnnotation) => void;
+/**
+ * Queue an annotation (called when user submits in MCP mode)
+ */
+declare function queueAnnotation(annotation: Annotation, comment: string): StoredAnnotation;
+/**
+ * Get all pending annotations
+ */
+declare function getPendingAnnotations(): StoredAnnotation[];
+/**
+ * Get all annotations (any status)
+ */
+declare function getAllAnnotations(): StoredAnnotation[];
+/**
+ * Get a specific annotation by ID
+ */
+declare function getAnnotation(id: string): StoredAnnotation | undefined;
+/**
+ * Mark an annotation as acknowledged (agent has seen it)
+ */
+declare function acknowledgeAnnotation(id: string): StoredAnnotation | undefined;
+/**
+ * Mark an annotation as resolved (agent has implemented the change)
+ */
+declare function resolveAnnotation(id: string, summary?: string): StoredAnnotation | undefined;
+/**
+ * Dismiss an annotation (agent decided not to address it)
+ */
+declare function dismissAnnotation(id: string, reason: string): StoredAnnotation | undefined;
+/**
+ * Remove an annotation from the store
+ */
+declare function removeAnnotation(id: string): StoredAnnotation | undefined;
+/**
+ * Clear all annotations
+ */
+declare function clearAnnotations(): void;
+/**
+ * Subscribe to store events
+ */
+declare function onStoreEvent(listener: StoreListener): () => void;
+/**
+ * Get count of pending annotations
+ */
+declare function getPendingCount(): number;
+
+export { type AIProviderConfig, type AIRunResult, type AIStreamEvent, type AnnotationStatus, type AIProvider as CLIProvider, DELETE, type DaemonConfig, type DaemonInstance, type DetailedDomSelectionInput, type DomSelectionInput, type DrawingInput, type ExecutionMode, type GeminiCLIEvent, type GeminiCLIOptions, type GestureInput, IMAGE_ANALYSIS_PROMPT, type IncomingMessage, type OutgoingMessage, POST, type ProjectContext, type ProviderName, type StoredAnnotation, type VisionAnalysisResult, type VisionConfig, acknowledgeAnnotation, analyzeImage, buildDetailedDomSelectionPrompt, buildDrawingToCodePrompt, buildFastDomSelectionPrompt, buildGesturePrompt, buildPromptFromAnnotation, clearAnnotations, createGeminiCLIStream, createGeminiRouteHandler, createRevertRouteHandler, dismissAnnotation, getAllAnnotations, getAnnotation, getAvailableProviders as getCLIProviders, getPendingAnnotations, getPendingCount, getTrackedAnnotations, isProviderAvailable, isVisionAvailable, onStoreEvent, queueAnnotation, removeAnnotation, resolveAnnotation, revertAnnotation, runAICLI, runGeminiCLI, spawnAICLI, spawnGeminiCLI, startDaemon };