@vibescope/mcp-server 0.0.1

package/src/handlers/types.ts

@@ -0,0 +1,88 @@
+import type { SupabaseClient } from '@supabase/supabase-js';
+
+/**
+ * Authentication context from API key validation
+ */
+export interface AuthContext {
+	userId: string;
+	apiKeyId: string;
+	organizationId?: string;
+	scope: 'personal' | 'organization';
+}
+
+/**
+ * Model-specific token tracking
+ */
+export interface ModelTokens {
+	input: number;
+	output: number;
+}
+
+/**
+ * Token usage tracking for the session
+ */
+export interface TokenUsage {
+	callCount: number;
+	totalTokens: number;
+	byTool: Record<string, { calls: number; tokens: number }>;
+	byModel: Record<string, ModelTokens>;
+	currentModel: string | null; // 'opus' | 'sonnet' | 'haiku' | null
+}
+
+/**
+ * Session state that persists across tool calls
+ */
+export interface SessionState {
+	instanceId: string;
+	currentSessionId: string | null;
+	currentPersona: string | null;
+	tokenUsage: TokenUsage;
+}
+
+/**
+ * User updates since last sync (for start_work_session full mode)
+ */
+export interface UserUpdates {
+	tasks?: Array<{ id: string; title: string; created_at: string }>;
+	blockers?: Array<{ id: string; description: string; created_at: string }>;
+	ideas?: Array<{ id: string; title: string; created_at: string }>;
+}
+
+/**
+ * Context passed to all handlers
+ */
+export interface HandlerContext {
+	supabase: SupabaseClient;
+	auth: AuthContext;
+	session: SessionState;
+	/** Update session state (for handlers that modify session) */
+	updateSession: (updates: Partial<Pick<SessionState, 'currentSessionId' | 'currentPersona' | 'tokenUsage'>>) => void;
+	/** Get user updates since last sync (for session handlers) */
+	getUserUpdates?: (projectId: string) => Promise<UserUpdates | undefined>;
+	/** Select an available persona for the agent */
+	selectPersona?: (usedPersonas: Set<string>, instanceId: string) => string;
+	/** Extract project name from git URL */
+	extractProjectNameFromGitUrl?: (gitUrl: string) => string;
+}
+
+/**
+ * Result returned by handlers
+ */
+export interface HandlerResult {
+	result?: unknown;
+	content?: Array<{ type: string; text: string }>;
+	isError?: boolean;
+}
+
+/**
+ * Handler function type
+ */
+export type Handler = (
+	args: Record<string, unknown>,
+	ctx: HandlerContext
+) => Promise<HandlerResult>;
+
+/**
+ * Handler registry - maps tool names to handler functions
+ */
+export type HandlerRegistry = Record<string, Handler>;