@astramindapp/mcp-server 0.2.0 → 0.3.1

package/src/mind-client.ts

@@ -1,378 +0,0 @@
-/**
- * MIND API Client
- *
- * Thin wrapper around the MIND Developer API.
- * All methods return typed responses or throw on HTTP errors.
- */
-
-export interface MindClientConfig {
-  baseUrl: string;
-  apiKey: string;
-}
-
-export interface QueryRequest {
-  query: string;
-  mode?: "mix" | "hybrid" | "graph" | "vector";
-  limit?: number;
-}
-
-export interface QueryResponse {
-  response: string;
-  sources: Array<{
-    id?: string;
-    title?: string;
-    content_preview?: string;
-    relevance_score?: number;
-  }>;
-  credits_used: number;
-  credits_remaining: number;
-}
-
-export interface DocumentCreateRequest {
-  title: string;
-  content: string;
-  source?: string;
-  tags?: string[];
-}
-
-export interface DocumentResponse {
-  id: string;
-  title: string;
-  source: string;
-  status: string;
-  created_at: string;
-  content_preview?: string;
-}
-
-export interface EntryCreateRequest {
-  title?: string;
-  content: string;
-  entry_type?: string;
-  tags?: string[];
-}
-
-export interface EntryResponse {
-  id?: string;
-  entry_id?: string;
-  title?: string;
-  content?: string;
-  entry_type?: string;
-  tags?: string[];
-  created_at?: string;
-}
-
-export interface ThoughtCreateRequest {
-  content: string;
-}
-
-export interface ThoughtResponse {
-  id?: string;
-  thought_id?: string;
-  content: string;
-  created_at?: string;
-}
-
-export interface LifeItemCreateRequest {
-  title: string;
-  description?: string;
-  status?: string;
-  priority?: string;
-  due_date?: string;
-}
-
-export interface LifeItemResponse {
-  item_id: string;
-  title: string;
-  description?: string;
-  status?: string;
-  priority?: string;
-  due_date?: string;
-  created_at?: string;
-}
-
-export interface CrmContactCreateRequest {
-  name: string;
-  email?: string;
-  company?: string;
-  type?: string;
-  stage?: string;
-  source?: string;
-  value?: number;
-  notes?: string;
-}
-
-export interface CrmContactResponse {
-  id?: string;
-  contact_id?: string;
-  name: string;
-  email?: string;
-  company?: string;
-  type?: string;
-  stage?: string;
-  created_at?: string;
-}
-
-export interface GraphInfoResponse {
-  total_entities: number;
-  total_relationships: number;
-  popular_labels?: Array<{ label: string | null; count: number }>;
-  storage_status?: { workspace_id: string; status: string };
-}
-
-export interface ProfileResponse {
-  username: string;
-  tier?: string;
-  credits_remaining?: number;
-  [key: string]: unknown;
-}
-
-export interface InsightsResponse {
-  insights: Array<{
-    id?: string;
-    type?: string;
-    content?: string;
-    created_at?: string;
-  }>;
-}
-
-class MindApiError extends Error {
-  constructor(
-    public status: number,
-    public statusText: string,
-    public body: string
-  ) {
-    super(`MIND API error ${status}: ${statusText} — ${body}`);
-    this.name = "MindApiError";
-  }
-}
-
-export class MindClient {
-  private baseUrl: string;
-  private apiKey: string;
-
-  constructor(config: MindClientConfig) {
-    this.baseUrl = config.baseUrl.replace(/\/+$/, "");
-    this.apiKey = config.apiKey;
-  }
-
-  private async request<T>(
-    method: string,
-    path: string,
-    body?: unknown,
-    params?: Record<string, string>
-  ): Promise<T> {
-    let url = `${this.baseUrl}${path}`;
-    if (params) {
-      const qs = new URLSearchParams(params).toString();
-      if (qs) url += `?${qs}`;
-    }
-
-    const headers: Record<string, string> = {
-      "X-API-Key": this.apiKey,
-      "Content-Type": "application/json",
-    };
-
-    const res = await fetch(url, {
-      method,
-      headers,
-      body: body ? JSON.stringify(body) : undefined,
-    });
-
-    const text = await res.text();
-    if (!res.ok) {
-      throw new MindApiError(res.status, res.statusText, text);
-    }
-
-    try {
-      return JSON.parse(text) as T;
-    } catch {
-      return text as unknown as T;
-    }
-  }
-
-  // ─── Query ──────────────────────────────────────────────
-
-  async query(req: QueryRequest): Promise<QueryResponse> {
-    return this.request<QueryResponse>("POST", "/developer/v1/query", req);
-  }
-
-  // ─── Documents ──────────────────────────────────────────
-
-  async createDocument(req: DocumentCreateRequest): Promise<DocumentResponse> {
-    return this.request<DocumentResponse>("POST", "/developer/v1/documents", req);
-  }
-
-  async listDocuments(page = 1, pageSize = 20): Promise<{ documents: DocumentResponse[] }> {
-    return this.request("GET", "/developer/v1/documents", undefined, {
-      page: String(page),
-      page_size: String(pageSize),
-    });
-  }
-
-  async deleteDocument(docId: string): Promise<void> {
-    await this.request("DELETE", `/developer/v1/documents/${docId}`);
-  }
-
-  // ─── Entries ────────────────────────────────────────────
-
-  async createEntry(req: EntryCreateRequest): Promise<EntryResponse> {
-    return this.request<EntryResponse>("POST", "/developer/v1/entries", req);
-  }
-
-  async listEntries(limit = 20): Promise<{ entries: EntryResponse[] }> {
-    return this.request("GET", "/developer/v1/entries", undefined, {
-      limit: String(limit),
-    });
-  }
-
-  async deleteEntry(entryId: string): Promise<void> {
-    await this.request("DELETE", `/developer/v1/entries/${entryId}`);
-  }
-
-  // ─── Thoughts ───────────────────────────────────────────
-
-  async createThought(req: ThoughtCreateRequest): Promise<ThoughtResponse> {
-    return this.request<ThoughtResponse>("POST", "/developer/v1/thoughts", req);
-  }
-
-  async listThoughts(): Promise<{ thoughts: ThoughtResponse[] }> {
-    return this.request("GET", "/developer/v1/thoughts");
-  }
-
-  async deleteThought(thoughtId: string): Promise<void> {
-    await this.request("DELETE", `/developer/v1/thoughts/${thoughtId}`);
-  }
-
-  // ─── Life ───────────────────────────────────────────────
-
-  async createLifeItem(req: LifeItemCreateRequest): Promise<LifeItemResponse> {
-    return this.request<LifeItemResponse>("POST", "/developer/v1/life/items", req);
-  }
-
-  async listLifeItems(
-    status?: string,
-    limit = 30
-  ): Promise<{ items: LifeItemResponse[] }> {
-    const params: Record<string, string> = { limit: String(limit) };
-    if (status) params.status = status;
-    return this.request("GET", "/developer/v1/life/items", undefined, params);
-  }
-
-  async updateLifeItem(
-    itemId: string,
-    patch: Partial<LifeItemCreateRequest & { status: string }>
-  ): Promise<LifeItemResponse> {
-    return this.request<LifeItemResponse>(
-      "PATCH",
-      `/developer/v1/life/items/${itemId}`,
-      patch
-    );
-  }
-
-  async deleteLifeItem(itemId: string): Promise<void> {
-    await this.request("DELETE", `/developer/v1/life/items/${itemId}`);
-  }
-
-  // ─── CRM ────────────────────────────────────────────────
-
-  async createContact(req: CrmContactCreateRequest): Promise<CrmContactResponse> {
-    return this.request<CrmContactResponse>("POST", "/developer/v1/crm/contacts", req);
-  }
-
-  async listContacts(): Promise<{ contacts: CrmContactResponse[] }> {
-    return this.request("GET", "/developer/v1/crm/contacts");
-  }
-
-  async updateContact(
-    contactId: string,
-    patch: Partial<CrmContactCreateRequest>
-  ): Promise<CrmContactResponse> {
-    return this.request<CrmContactResponse>(
-      "PATCH",
-      `/developer/v1/crm/contacts/${contactId}`,
-      patch
-    );
-  }
-
-  // ─── Graph ──────────────────────────────────────────────
-
-  async graphInfo(): Promise<GraphInfoResponse> {
-    return this.request<GraphInfoResponse>("GET", "/developer/v1/graph");
-  }
-
-  // ─── Profile / Credits ─────────────────────────────────
-
-  async profile(): Promise<ProfileResponse> {
-    return this.request<ProfileResponse>("GET", "/developer/v1/profile");
-  }
-
-  async credits(): Promise<{
-    credits_balance: number;
-    credits_limit: number;
-    tier: string;
-    documents_used: number;
-    documents_limit: number;
-  }> {
-    return this.request("GET", "/developer/v1/credits");
-  }
-
-  // ─── Insights ───────────────────────────────────────────
-
-  async insights(): Promise<InsightsResponse> {
-    return this.request<InsightsResponse>("GET", "/developer/v1/insights");
-  }
-
-  // ─── Admin ──────────────────────────────────────────────
-
-  async adminCreateUser(req: { username: string; email: string; password: string }): Promise<{
-    status: string;
-    user: { username: string; email: string; workspace_id: string };
-  }> {
-    return this.request("POST", "/register", req);
-  }
-
-  async adminCreateFeaturedMind(req: {
-    username: string;
-    title: string;
-    description?: string;
-    tags?: string[];
-    price?: number;
-    featured?: boolean;
-    display_order?: number;
-    is_public?: boolean;
-    avatar_url?: string;
-  }): Promise<{ mind_id: string; username: string; title: string; [key: string]: unknown }> {
-    return this.request("POST", "/admin/featured-minds", req);
-  }
-
-  async adminListFeaturedMinds(): Promise<
-    Array<{ mind_id: string; username: string; title: string; featured: boolean; display_order: number; [key: string]: unknown }>
-  > {
-    return this.request("GET", "/admin/featured-minds");
-  }
-
-  async adminUpdateFeaturedMind(
-    mindId: string,
-    patch: Record<string, unknown>
-  ): Promise<{ mind_id: string; title: string; [key: string]: unknown }> {
-    return this.request("PUT", `/admin/featured-minds/${mindId}`, patch);
-  }
-
-  async adminListUsers(params?: { q?: string; page?: number }): Promise<{
-    users: Array<{ username: string; email?: string; tier?: string; doc_count?: number }>;
-    total?: number;
-  }> {
-    const qp: Record<string, string> = {};
-    if (params?.q) qp.q = params.q;
-    if (params?.page) qp.page = String(params.page);
-    return this.request("GET", "/admin/users", undefined, qp);
-  }
-
-  async adminUpdateUserTier(username: string, tier: string): Promise<{ tier: string }> {
-    return this.request("PUT", `/admin/users/${username}/tier`, { tier });
-  }
-
-  async adminAdjustCredits(username: string, amount: number): Promise<{ new_balance: number }> {
-    return this.request("POST", `/admin/users/${username}/credits`, { amount });
-  }
-}