@vennyx/solicrm-mcp 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,399 @@
+import { z } from "zod";
+import { McpServer, RegisteredPrompt, RegisteredResourceTemplate, RegisteredTool } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ActivityListQuery, CrmListQuery, SearchParams, SolicrmApiError, SolicrmClient, SolicrmError, SolicrmResponseError } from "@vennyx/solicrm";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+//#region packages/contracts/src/api-keys.d.ts
+declare const apiKeyScopeSchema: z.ZodEnum<{
+  admin: "admin";
+  read: "read";
+  write: "write";
+}>;
+type ApiKeyScope = z.infer<typeof apiKeyScopeSchema>;
+//#endregion
+//#region packages/contracts/src/fields.d.ts
+/**
+ * Alan kataloğu — `field_key` → kolon/tip/yetenek eşlemesi.
+ *
+ * NEDEN VAR: kaydedilmiş görünümler, filtreler, sıralama, CSV içe/dışa aktarma
+ * ve MCP/SDK tip üretimi HEPSİ bu katalogdan okur. Hiçbir yerde kullanıcıdan
+ * gelen bir değer doğrudan kolon adına dönüşmez — `resolveField()` bilinmeyen
+ * anahtar için `undefined` döner ve çağıran 400 verir. Bu, SQL enjeksiyonu ve
+ * bilgi sızdırmanın sınırıdır.
+ *
+ * İLERİYE DÖNÜK: özel alanlar (custom fields) eklendiğinde katalog runtime'da
+ * tenant'ın tanımlarıyla genişletilir; tüketici kod değişmez (bkz. spec §6.7).
+ */
+declare const CRM_RESOURCES: readonly ['contacts', 'companies', 'deals', 'tasks'];
+type CrmResource = (typeof CRM_RESOURCES)[number];
+//#endregion
+//#region packages/mcp/dist/client.d.ts
+/**
+ * ARGÜMANLARI SDK'nın imzasından AYNEN alır, DÖNÜŞ tipini `Promise<unknown>`'a
+ * genişletir.
+ *
+ * NEDEN DÖNÜŞ GEVŞEK: MCP katmanı hiçbir yanıt alanını OKUMAZ — her araç
+ * sonucu doğrudan `jsonResult()`'a, yani `JSON.stringify`'a gider. Dönüş
+ * tipini burada sıkı tutmak sıfır güvenlik/doğruluk kazancı sağlar ama sahte
+ * bir istemcinin tipi karşılamasını İMKÂNSIZ kılar ⇒ testler ancak `as`
+ * cast'iyle yazılabilirdi (yasak). Yük TAŞIYAN taraf ARGÜMANLARDIR ve onlar
+ * TAM SIKI kalır: `CallOptions` (`{ tenantId }`) parametresinin kaçıncı
+ * argüman olduğu, gövde şemalarının contracts tipleriyle uyumu ve id
+ * parametrelerinin `string`liği hepsi SDK'nın kendi imzasından gelir.
+ * Gerçek `SolicrmClient` bunu karşılar (fonksiyon dönüşleri KOVARYANT).
+ */
+type LoosenResult<TFn> = TFn extends ((...args: infer TArgs) => Promise<unknown>) ? (...args: TArgs) => Promise<unknown> : never;
+type LoosenResource<TResource> = { [K in keyof TResource]: LoosenResult<TResource[K]>; };
+interface McpSolicrmClient {
+  contacts: LoosenResource<Pick<SolicrmClient['contacts'], 'list' | 'get' | 'create' | 'update'>>;
+  companies: LoosenResource<Pick<SolicrmClient['companies'], 'list' | 'get' | 'create' | 'update'>>;
+  deals: LoosenResource<Pick<SolicrmClient['deals'], 'list' | 'get' | 'create' | 'update' | 'move'>>;
+  pipelines: LoosenResource<Pick<SolicrmClient['pipelines'], 'list'>>;
+  activities: LoosenResource<Pick<SolicrmClient['activities'], 'list' | 'create'>>;
+  tasks: LoosenResource<Pick<SolicrmClient['tasks'], 'list' | 'create' | 'complete'>>;
+  notes: LoosenResource<Pick<SolicrmClient['notes'], 'create'>>;
+  search: LoosenResource<Pick<SolicrmClient['search'], 'query'>>;
+  views: LoosenResource<Pick<SolicrmClient['views'], 'list'>>;
+}
+/**
+ * TİP DÜZEYİ KANIT — gerçek `SolicrmClient` bu dar yüzeyi KARŞILIYOR.
+ * Fonksiyon hiç ÇAĞRILMAZ; tek işi `tsc -b`'yi bir sapmada kırmaktır (bir
+ * metot adı değişir/kaldırılırsa derleme burada patlar). `as` cast'i YOK,
+ * çalışma zamanı maliyeti YOK.
+ */
+declare function assertSolicrmClientSatisfiesMcpSurface(client: SolicrmClient): McpSolicrmClient;
+//#endregion
+//#region packages/mcp/dist/config.d.ts
+interface McpConfig {
+  apiKey: string;
+  tenantId: string;
+  /** Verilmezse `@vennyx/solicrm`'in `DEFAULT_BASE_URL`'ü kullanılır */
+  baseUrl: string | undefined;
+  /** Bkz. KRİTİK KURAL 3 — yalnız `tools/list` filtresi */
+  scope: ApiKeyScope;
+}
+/** Bkz. KRİTİK KURAL 3 — kapsam verilmediğinde sunucuyu yetkili taraf sayarız */
+declare const DEFAULT_MCP_SCOPE: ApiKeyScope;
+/** `process.env` biçiminde okunabilen minimal yüzey (testte düz obje geçilir) */
+type McpEnv = Record<string, string | undefined>;
+declare function loadConfigFromEnv(env: McpEnv): McpConfig;
+//#endregion
+//#region packages/mcp/dist/transports/http.d.ts
+/** Bkz. KRİTİK KURAL 1(a) */
+declare const DEFAULT_HTTP_HOST = "127.0.0.1";
+declare const DEFAULT_HTTP_PORT = 3737;
+/** `--http` sunucusunun MCP yolu */
+declare const MCP_HTTP_PATH = "/mcp";
+declare const BROWSER_ORIGIN_REJECTED_MESSAGE = "Tarayıcıdan gelen istekler reddedilir (Origin başlığı taşıyor).";
+interface McpHttpHandlerDeps {
+  /** Her istek için TAZE bir sunucu üretir (bkz. KRİTİK KURAL 3) */
+  createServer: () => McpServer;
+}
+/** Bkz. KRİTİK KURAL 1(b) — saf, tek satırlık, ayrı test edilebilir karar */
+declare function hasBrowserOrigin(request: Request): boolean;
+/**
+ * `Request → Response`. Port açmaz, soket kurmaz ⇒ testte doğrudan çağrılır.
+ * Protokol hataları JSON-RPC zarfıyla transport'tan gelir; BU katmanın kendi
+ * redleri (405/404/403) `{error}` zarfını kullanır — hosted uçtaki AYNI ayrım
+ * (bkz. `apps/api/src/routes/mcp.ts` KRİTİK KURAL 5).
+ */
+declare function createMcpHttpHandler(deps: McpHttpHandlerDeps): (request: Request) => Promise<Response>;
+interface McpHttpServerOptions {
+  handler: (request: Request) => Promise<Response>;
+  port?: number | undefined;
+  host?: string | undefined;
+}
+interface RunningMcpHttpServer {
+  host: string;
+  port: number;
+  close: () => Promise<void>;
+}
+/**
+ * `node:http` yapıştırıcısı — Node ve Bun'da AYNI şekilde çalışır (`Bun.serve`
+ * kullanılmadı: paket npm'e yayınlanıyor ve `npx` altında Node ile koşuyor).
+ */
+declare function startMcpHttpServer(options: McpHttpServerOptions): Promise<RunningMcpHttpServer>;
+//#endregion
+//#region packages/mcp/dist/cli.d.ts
+type McpTransportKind = 'stdio' | 'http';
+interface CliArgs {
+  transport: McpTransportKind;
+  /** Yalnız `transport === 'http'` iken anlamlı; verilmemişse `undefined` */
+  port: number | undefined;
+  /** `--help` / `-h` verildi mi */
+  help: boolean;
+  /** `--version` / `-v` verildi mi */
+  version: boolean;
+}
+declare const USAGE = "solicrm-mcp — SoliCRM MCP sunucusu (v0.1.0)\n\nKullanım:\n  solicrm-mcp                 stdio taşımasıyla başlar (varsayılan)\n  solicrm-mcp --http [port]   bağımsız Streamable HTTP sunucusu (varsayılan port 3737)\n  solicrm-mcp --help          bu metni yazar\n  solicrm-mcp --version       sürümü yazar\n\nOrtam değişkenleri:\n  SOLICRM_API_KEY    (zorunlu) scrm_ ile başlayan tenant API anahtarı\n  SOLICRM_TENANT_ID  (zorunlu) kiracı kimliği (UUID)\n  SOLICRM_BASE_URL   (opsiyonel) API tabanı; verilmezse https://api.solicrm.com\n  SOLICRM_SCOPE      (opsiyonel) read|write|admin — yalnız tools/list filtresi,\n                     gerçek yetki sunucuda her istekte yeniden hesaplanır";
+/** Bkz. KRİTİK KURAL 3 */
+declare function parsePort(raw: string): number;
+declare function parseCliArgs(argv: readonly string[]): CliArgs;
+interface RunCliDeps {
+  env?: McpEnv | undefined;
+  loadConfig?: ((env: McpEnv) => McpConfig) | undefined;
+  /** Kurulmuş bir SDK istemcisi üretir (gerçek uygulama `@vennyx/solicrm`'i kullanır) */
+  createClient?: ((config: McpConfig) => McpSolicrmClient) | undefined;
+  createServer?: ((client: McpSolicrmClient, scope: ApiKeyScope) => McpServer) | undefined;
+  connectStdio?: ((server: McpServer) => Promise<unknown>) | undefined;
+  startHttp?: ((args: {
+    handler: (request: Request) => Promise<Response>;
+    port: number | undefined;
+  }) => Promise<RunningMcpHttpServer>) | undefined;
+  /** İnsana yönelik çıktı — bkz. KRİTİK KURAL 2 */
+  log?: ((message: string) => void) | undefined;
+}
+declare function runCli(argv: readonly string[], deps?: RunCliDeps): Promise<void>;
+//#endregion
+//#region packages/mcp/dist/errors.d.ts
+/**
+ * MCP katmanının KENDİ hata sınıfları — sunucudan GELMEYEN, bu paketin
+ * ürettiği başarısızlıklar.
+ *
+ * DİL İSTİSNASI (Global Constraints #8): buradaki mesajlar İngilizce'dir.
+ * "Kullanıcıya dönen mesajlar Türkçe" kuralı `apps/api`'nin `jsonError()`
+ * zarfı içindir; bu paket global npm tüketicilerine (Claude Code/Desktop) gider
+ * ve mesajları bir LLM okur. Sunucudan gelen TÜRKÇE metin ise ÇEVRİLMEZ,
+ * `toMcpToolError` onu AYNEN taşır (bkz. `result.ts`).
+ */
+/** Bu paketin ürettiği her hatanın taban sınıfı — tüketici tek `catch` ile kapsar. */
+declare class SolicrmMcpError extends Error {
+  constructor(message: string);
+}
+/**
+ * Çağıranın etkin kapsamı aracın gerektirdiği minimumun ALTINDA.
+ *
+ * KRİTİK KURAL — bu hata TEK yetki sınırı DEĞİLDİR, İKİNCİ katmandır. Gerçek
+ * yetki kontrolü sunucu tarafındadır: her araç çağrısı SDK üzerinden
+ * `/v1/tenants/:id/...` uçlarına gider ve orada
+ * `checkApiKeyTenantAndScope` (`apps/api/src/lib/crm-access.ts`) çalışır — o
+ * kontrol `effectiveScope`'u (= `ROLE_SCOPE_CEILING[güncel rol] ∩ anahtar
+ * kapsamı`) HER istekte DB'den YENİDEN hesaplar. Bu paketteki `scope` ise
+ * sunucu kurulurken bir kez alınmış bir ANLIK GÖRÜNTÜDÜR (bkz. `scope.ts`).
+ */
+declare class McpScopeError extends SolicrmMcpError {
+  readonly toolName: string;
+  readonly requiredScope: string;
+  readonly actualScope: string;
+  constructor(params: {
+    toolName: string;
+    requiredScope: string;
+    actualScope: string;
+  });
+}
+/**
+ * Araç girdisi zod şemasını GEÇTİ ama anlamsal olarak tutarsız (ör. sıralama
+ * yönü verilmiş, sıralanacak alan verilmemiş).
+ *
+ * NEDEN AYRI BİR HATA: bu projenin "fail-open savunma savunma değildir"
+ * dersinin doğrudan uygulaması — tutarsız girdiyi SESSİZCE yok saymak
+ * (`sortDirection`'ı görmezden gelip sırasız sonuç döndürmek) çağırana
+ * "istediğin sıralamayı yaptım" yalanını söylerdi.
+ */
+declare class McpInputError extends SolicrmMcpError {
+  constructor(message: string);
+}
+//#endregion
+//#region packages/mcp/dist/list-input.d.ts
+/**
+ * Bir CRM kaynağı için liste aracı girdi şeması. Alan adları o kaynağın
+ * `FIELD_CATALOG` girdisine karşı doğrulanır (bkz. KRİTİK KURAL 4).
+ */
+declare function buildCrmListInputSchema(resource: CrmResource): z.ZodObject<{
+  cursor: z.ZodOptional<z.ZodString>;
+  limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+  sortField: z.ZodOptional<z.ZodString>;
+  sortDirection: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+  filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+type CrmListInput = z.infer<ReturnType<typeof buildCrmListInputSchema>>;
+/**
+ * Araç girdisini SDK'nın `CrmListQuery`'sine çevirir. `tenantId` DİYE BİR ALAN
+ * YOKTUR ve olamaz — tenant her zaman `SolicrmClient`'ın kurulduğu andaki
+ * değerdir (bkz. `server.ts` dosya başı).
+ */
+declare function toCrmListQuery(args: CrmListInput): CrmListQuery;
+/**
+ * Bir kaynağın sıralanabilir/filtrelenebilir alanlarını araç açıklamasına
+ * yazılacak metne çevirir — LLM'in geçersiz alan adı denemesini azaltır.
+ * Liste `FIELD_CATALOG`'dan ÜRETİLİR, elle yazılmaz.
+ */
+declare function describeCrmListFields(resource: CrmResource): string;
+//#endregion
+//#region packages/mcp/dist/prompts.d.ts
+declare const MCP_PROMPT_NAMES: readonly ['summarize_pipeline'];
+declare function registerSummarizePipelinePrompt(server: McpServer): RegisteredPrompt;
+//#endregion
+//#region packages/mcp/dist/resources.d.ts
+declare const MCP_RESOURCE_NAMES: readonly ['contact', 'deal'];
+type McpResourceName = (typeof MCP_RESOURCE_NAMES)[number];
+/** Kaynak → gereken minimum kapsam. `TOOL_MIN_SCOPE` gibi TOTAL (fail-open yok). */
+declare const RESOURCE_MIN_SCOPE: Record<McpResourceName, ApiKeyScope>;
+/** URI şablonu değişkeni tek değer de dizi de olabilir — ilkini alır, yoksa hata. */
+declare function firstVariable(value: string | string[] | undefined, name: string): string;
+declare function registerCrmResources(server: McpServer, client: McpSolicrmClient, scope: ApiKeyScope): Array<[McpResourceName, RegisteredResourceTemplate]>;
+//#endregion
+//#region packages/mcp/dist/result.d.ts
+/** Beklenmeyen (bizim kusurumuz olan) hatalar için TEK jenerik metin. */
+declare const UNEXPECTED_ERROR_MESSAGE = "An unexpected error occurred while calling the SoliCRM API.";
+/**
+ * SDK'nın hata sınıflarının `this.name` değerlerinin KAPALI listesi. Listede
+ * OLMAYAN her şey jenerik metne düşer (fail-closed).
+ */
+declare const SDK_ERROR_NAMES: readonly string[];
+/** `SolicrmApiError`'ın bu modülün OKUDUĞU alanları — yapısal sözleşme. */
+interface ApiErrorShape {
+  status: number;
+  body: unknown;
+  serverMessage: string | undefined;
+  message: string;
+}
+/**
+ * TİP DÜZEYİ KANIT (a): gerçek `SolicrmApiError` yukarıdaki yapısal sözleşmeyi
+ * KARŞILIYOR. Hiç çağrılmaz; tek işi bir sapmada `tsc -b`'yi kırmaktır.
+ */
+declare function assertApiErrorShape(err: SolicrmApiError): ApiErrorShape;
+/**
+ * TİP DÜZEYİ KANIT (a-2): `SDK_ERROR_NAMES`'in karşılık geldiği ÜÇ sınıf
+ * gerçekten var ve hepsi `Error` alt sınıfı. Biri kaldırılır/yeniden
+ * adlandırılırsa import satırı ve bu imza DERLENMEZ.
+ */
+declare function assertSdkErrorNames(errors: [SolicrmError, SolicrmApiError, SolicrmResponseError]): Error[];
+/**
+ * `@modelcontextprotocol/sdk`'nın `CallToolResult` şeklinin bu paketin ihtiyacı
+ * kadarlık dar karşılığı. SDK'nın gerçek zod şeması `[x: string]: unknown`
+ * (loose) taşır — bu tip de UYUMLU kalmak için aynısını taşır.
+ */
+interface ToolTextResult {
+  [key: string]: unknown;
+  content: {
+    type: 'text';
+    text: string;
+  }[];
+  isError?: boolean;
+}
+/** Her aracın ORTAK başarı biçimi — veriyi okunabilir (girintili) JSON metne çevirir. */
+declare function jsonResult(data: unknown): ToolTextResult;
+/** Bir hatayı MCP'nin `isError: true` sonucuna çevirir (JSON-RPC hatası DEĞİL). */
+declare function toMcpToolError(err: unknown): ToolTextResult;
+//#endregion
+//#region packages/mcp/dist/scope.d.ts
+/**
+ * Kayıtlı TÜM araçların kanonik ad listesi (spec §12.1'in 22 aracı — `search`
+ * dâhil; plan metninin "21 araç" sayımı hatalıdır, `search` ZATEN §12.1
+ * listesindedir, ona EK değildir).
+ *
+ * Bu dizi TEK gerçek kaynaktır: `TOOL_MIN_SCOPE` ondan tiplenir ve
+ * `test/server.test.ts` `tools/list` çıktısının bununla BİREBİR eşleştiğini
+ * doğrular.
+ */
+declare const MCP_TOOL_NAMES: readonly ['list_contacts', 'get_contact', 'create_contact', 'update_contact', 'list_companies', 'get_company', 'create_company', 'update_company', 'list_deals', 'get_deal', 'create_deal', 'update_deal', 'move_deal_stage', 'list_pipelines', 'list_activities', 'create_activity', 'list_tasks', 'create_task', 'complete_task', 'create_note', 'search', 'list_saved_views'];
+type McpToolName = (typeof MCP_TOOL_NAMES)[number];
+/**
+ * Kapsam rütbeleri — `apps/api/src/lib/api-key-auth.ts`'in `SCOPE_RANK`'ıyla
+ * BİREBİR aynı. İçe aktarılMAZ çünkü bu paket npm'e yayınlanır ve `apps/api`'ye
+ * (Hono, Drizzle, Postgres) bağımlı OLAMAZ. Drift riski TİP SEVİYESİNDE
+ * kapatılmıştır: `Record<ApiKeyScope, number>` `@solicrm/contracts`'ın
+ * `apiKeyScopeSchema` enum'una bağlıdır ⇒ contracts'a dördüncü bir kapsam
+ * eklenirse bu satır DERLENMEZ.
+ */
+declare const SCOPE_RANK: Record<ApiKeyScope, number>;
+/** `SCOPE_RANK`'ın anahtar kümesinin contracts'la aynı olduğunu ÇALIŞMA ZAMANINDA da kanıtlanabilir kılar. */
+declare const API_KEY_SCOPES: readonly ApiKeyScope[];
+declare const TOOL_MIN_SCOPE: Record<McpToolName, ApiKeyScope>;
+/** `actual`, `required` kapsamını karşılıyor mu (read < write < admin) */
+declare function scopeSatisfies(actual: ApiKeyScope, required: ApiKeyScope): boolean;
+/**
+ * Çağrı-anı kapsam kapısı — HER araç handler'ının İLK satırı (bkz. KRİTİK
+ * KURAL 3/b). Yetersizse fırlatır; `toMcpToolError` bunu `isError: true`
+ * sonucuna çevirir.
+ */
+declare function assertScope(scope: ApiKeyScope, toolName: McpToolName): void;
+//#endregion
+//#region packages/mcp/dist/server.d.ts
+/** `dist/cli.js`'nin (Task 4) `package.json` okumadan taşıdığı sürüm sabiti. */
+declare const SOLICRM_MCP_VERSION = "0.1.0";
+declare const SOLICRM_MCP_SERVER_NAME = "solicrm";
+/**
+ * Verilen istemci ve etkin kapsam için TAZE bir `McpServer` kurar.
+ *
+ * @param client Kurulmuş `SolicrmClient` — `tenantId`'si (ve API anahtarı)
+ *   çağıranın kimliğinden gelir; bu fonksiyon onu SORGULAMAZ ve DEĞİŞTİRMEZ.
+ * @param scope Çağıranın ŞU ANDAKİ etkin kapsamı (`ROLE_SCOPE_CEILING[rol] ∩
+ *   anahtar kapsamı`). Anlık görüntüdür — bkz. `scope.ts` KRİTİK KURAL 2.
+ */
+declare function createSolicrmMcpServer(client: McpSolicrmClient, scope: ApiKeyScope): McpServer;
+//#endregion
+//#region packages/mcp/dist/tools/activities.d.ts
+declare const listActivitiesInputSchema: z.ZodObject<{
+  cursor: z.ZodOptional<z.ZodString>;
+  limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+  targetType: z.ZodOptional<z.ZodEnum<{
+    company: "company";
+    contact: "contact";
+    deal: "deal";
+  }>>;
+  targetId: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strip>;
+type ListActivitiesInput = z.infer<typeof listActivitiesInputSchema>;
+declare function toActivityListQuery(args: ListActivitiesInput): ActivityListQuery;
+declare function registerActivityTools(server: McpServer, client: McpSolicrmClient, scope: ApiKeyScope): Array<[McpToolName, RegisteredTool]>;
+//#endregion
+//#region packages/mcp/dist/tools/companies.d.ts
+declare function registerCompanyTools(server: McpServer, client: McpSolicrmClient, scope: ApiKeyScope): Array<[McpToolName, RegisteredTool]>;
+//#endregion
+//#region packages/mcp/dist/tools/contacts.d.ts
+declare function registerContactTools(server: McpServer, client: McpSolicrmClient, scope: ApiKeyScope): Array<[McpToolName, RegisteredTool]>;
+//#endregion
+//#region packages/mcp/dist/tools/deals.d.ts
+declare function registerDealTools(server: McpServer, client: McpSolicrmClient, scope: ApiKeyScope): Array<[McpToolName, RegisteredTool]>;
+//#endregion
+//#region packages/mcp/dist/tools/define.d.ts
+/**
+ * Bir araç handler'ını MCP callback'ine çevirir: kapsam kapısı → handler →
+ * `jsonResult`; her fırlatma `isError: true` sonucuna dönüşür (JSON-RPC
+ * hatasına DEĞİL — LLM hatayı okuyup düzeltebilsin).
+ */
+declare function guarded<TArgs>(scope: ApiKeyScope, name: McpToolName, handler: (args: TArgs) => Promise<unknown>): (args: TArgs) => Promise<ToolTextResult>;
+/** Girdi almayan araçlar için (`list_pipelines`) — aynı üç garanti, argümansız. */
+declare function guardedNoArgs(scope: ApiKeyScope, name: McpToolName, handler: () => Promise<unknown>): () => Promise<ToolTextResult>;
+//#endregion
+//#region packages/mcp/dist/tools/ids.d.ts
+/** `label` Türkçe okunur bir isimdir ("kişi", "şirket", "fırsat"...) */
+declare function idField(label: string): z.ZodUUID;
+//#endregion
+//#region packages/mcp/dist/tools/notes.d.ts
+declare function registerNoteTools(server: McpServer, client: McpSolicrmClient, scope: ApiKeyScope): Array<[McpToolName, RegisteredTool]>;
+//#endregion
+//#region packages/mcp/dist/tools/pipelines.d.ts
+declare function registerPipelineTools(server: McpServer, client: McpSolicrmClient, scope: ApiKeyScope): Array<[McpToolName, RegisteredTool]>;
+//#endregion
+//#region packages/mcp/dist/tools/search.d.ts
+declare const searchInputSchema: z.ZodObject<{
+  q: z.ZodString;
+  limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+  resources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    companies: "companies";
+    contacts: "contacts";
+    deals: "deals";
+  }>>>;
+}, z.core.$strip>;
+type SearchInput = z.infer<typeof searchInputSchema>;
+declare function toSearchParams(args: SearchInput): SearchParams;
+declare function registerSearchTools(server: McpServer, client: McpSolicrmClient, scope: ApiKeyScope): Array<[McpToolName, RegisteredTool]>;
+//#endregion
+//#region packages/mcp/dist/tools/tasks.d.ts
+declare function registerTaskTools(server: McpServer, client: McpSolicrmClient, scope: ApiKeyScope): Array<[McpToolName, RegisteredTool]>;
+//#endregion
+//#region packages/mcp/dist/tools/views.d.ts
+declare function registerSavedViewTools(server: McpServer, client: McpSolicrmClient, scope: ApiKeyScope): Array<[McpToolName, RegisteredTool]>;
+//#endregion
+//#region packages/mcp/dist/tools/index.d.ts
+declare function registerAllTools(server: McpServer, client: McpSolicrmClient, scope: ApiKeyScope): Array<[McpToolName, RegisteredTool]>;
+//#endregion
+//#region packages/mcp/dist/transports/stdio.d.ts
+declare function connectStdioTransport(server: McpServer): Promise<StdioServerTransport>;
+//#endregion
+export { API_KEY_SCOPES, type ApiKeyScope, BROWSER_ORIGIN_REJECTED_MESSAGE, type CliArgs, type CrmListInput, DEFAULT_HTTP_HOST, DEFAULT_HTTP_PORT, DEFAULT_MCP_SCOPE, MCP_HTTP_PATH, MCP_PROMPT_NAMES, MCP_RESOURCE_NAMES, MCP_TOOL_NAMES, type McpConfig, type McpEnv, type McpHttpHandlerDeps, McpInputError, type McpResourceName, McpScopeError, type McpSolicrmClient, type McpToolName, type McpTransportKind, RESOURCE_MIN_SCOPE, type RunCliDeps, type RunningMcpHttpServer, SCOPE_RANK, SDK_ERROR_NAMES, SOLICRM_MCP_SERVER_NAME, SOLICRM_MCP_VERSION, SolicrmMcpError, TOOL_MIN_SCOPE, type ToolTextResult, UNEXPECTED_ERROR_MESSAGE, USAGE, apiKeyScopeSchema, assertApiErrorShape, assertScope, assertSdkErrorNames, assertSolicrmClientSatisfiesMcpSurface, buildCrmListInputSchema, connectStdioTransport, createMcpHttpHandler, createSolicrmMcpServer, describeCrmListFields, firstVariable, guarded, guardedNoArgs, hasBrowserOrigin, idField, jsonResult, loadConfigFromEnv, parseCliArgs, parsePort, registerActivityTools, registerAllTools, registerCompanyTools, registerContactTools, registerCrmResources, registerDealTools, registerNoteTools, registerPipelineTools, registerSavedViewTools, registerSearchTools, registerSummarizePipelinePrompt, registerTaskTools, runCli, scopeSatisfies, startMcpHttpServer, toActivityListQuery, toCrmListQuery, toMcpToolError, toSearchParams };