@ghostpaw/affinity 0.2.4 → 0.3.0

package/dist/mcp.d.cts

@@ -0,0 +1,89 @@
+import { A as AffinityDb } from './database-C__PzPpi.cjs';
+import { Readable, Writable } from 'node:stream';
+
+declare const affinityMcpInstructions = "Affinity is a local relationship model and social CRM. Search before creating contacts. Inspect before revising or merging. Record direct evidence honestly, keep identities and structural ties distinct from social links, and ask for clarification when a target is ambiguous. Review commitments and recurring dates regularly. Derived scores guide attention and do not prove relationship quality.";
+
+declare function serveAffinityMcp(options?: {
+    db?: AffinityDb;
+    dbPath?: string;
+}): Promise<void>;
+
+interface JsonSchema {
+    type?: string | readonly string[] | undefined;
+    description?: string | undefined;
+    properties?: Record<string, JsonSchema> | undefined;
+    required?: readonly string[] | undefined;
+    enum?: readonly unknown[] | undefined;
+    items?: JsonSchema | undefined;
+    oneOf?: readonly JsonSchema[] | undefined;
+}
+interface SurfaceTool<TCtx> {
+    name: string;
+    title?: string;
+    description: string;
+    inputSchema: JsonSchema & {
+        type: "object";
+    };
+    whenToUse?: string;
+    whenNotToUse?: string;
+    readOnly?: boolean;
+    sideEffects?: string;
+    handler(ctx: TCtx, input: Record<string, unknown>): unknown | Promise<unknown>;
+}
+interface ToolAnnotations {
+    readOnlyHint: boolean;
+    destructiveHint: boolean;
+    idempotentHint: boolean;
+    openWorldHint: boolean;
+}
+interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id?: string | number | null;
+    method: string;
+    params?: Record<string, unknown>;
+}
+interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+type JsonRpcResponse = {
+    jsonrpc: "2.0";
+    id: string | number | null;
+} & ({
+    result: object;
+} | {
+    error: JsonRpcError;
+});
+interface McpServer {
+    handleMessage(msg: unknown): Promise<object | undefined>;
+    handleLine(line: string): Promise<string | undefined>;
+}
+declare function isErrorResult(result: unknown): boolean;
+
+declare const MCP_LATEST_PROTOCOL_VERSION = "2026-07-28";
+declare const MCP_SUPPORTED_PROTOCOL_VERSIONS: readonly ["2026-07-28", "2025-11-25", "2025-06-18", "2025-03-26", "2024-11-05"];
+interface McpServerOptions<TCtx> {
+    name: string;
+    version: string;
+    title?: string;
+    description?: string;
+    instructions?: string;
+    tools: readonly SurfaceTool<TCtx>[];
+    context: () => TCtx | Promise<TCtx>;
+    annotations?: (tool: SurfaceTool<TCtx>) => ToolAnnotations;
+    isErrorResult?: (result: unknown) => boolean;
+}
+declare function createMcpServer<TCtx>(options: McpServerOptions<TCtx>): McpServer;
+
+declare function serveMcpStdio(server: McpServer, options?: {
+    input?: Readable;
+    output?: Writable;
+}): Promise<void>;
+
+declare function createAffinityMcpServer(options?: {
+    db?: AffinityDb;
+    dbPath?: string;
+}): McpServer;
+
+export { type JsonRpcError, type JsonRpcRequest, type JsonRpcResponse, type JsonSchema, MCP_LATEST_PROTOCOL_VERSION, MCP_SUPPORTED_PROTOCOL_VERSIONS, type McpServer, type McpServerOptions, type SurfaceTool, type ToolAnnotations, affinityMcpInstructions, createAffinityMcpServer, createMcpServer, isErrorResult, serveAffinityMcp, serveMcpStdio };

package/dist/mcp.d.ts

@@ -0,0 +1,89 @@
+import { A as AffinityDb } from './database-C__PzPpi.js';
+import { Readable, Writable } from 'node:stream';
+
+declare const affinityMcpInstructions = "Affinity is a local relationship model and social CRM. Search before creating contacts. Inspect before revising or merging. Record direct evidence honestly, keep identities and structural ties distinct from social links, and ask for clarification when a target is ambiguous. Review commitments and recurring dates regularly. Derived scores guide attention and do not prove relationship quality.";
+
+declare function serveAffinityMcp(options?: {
+    db?: AffinityDb;
+    dbPath?: string;
+}): Promise<void>;
+
+interface JsonSchema {
+    type?: string | readonly string[] | undefined;
+    description?: string | undefined;
+    properties?: Record<string, JsonSchema> | undefined;
+    required?: readonly string[] | undefined;
+    enum?: readonly unknown[] | undefined;
+    items?: JsonSchema | undefined;
+    oneOf?: readonly JsonSchema[] | undefined;
+}
+interface SurfaceTool<TCtx> {
+    name: string;
+    title?: string;
+    description: string;
+    inputSchema: JsonSchema & {
+        type: "object";
+    };
+    whenToUse?: string;
+    whenNotToUse?: string;
+    readOnly?: boolean;
+    sideEffects?: string;
+    handler(ctx: TCtx, input: Record<string, unknown>): unknown | Promise<unknown>;
+}
+interface ToolAnnotations {
+    readOnlyHint: boolean;
+    destructiveHint: boolean;
+    idempotentHint: boolean;
+    openWorldHint: boolean;
+}
+interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id?: string | number | null;
+    method: string;
+    params?: Record<string, unknown>;
+}
+interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+type JsonRpcResponse = {
+    jsonrpc: "2.0";
+    id: string | number | null;
+} & ({
+    result: object;
+} | {
+    error: JsonRpcError;
+});
+interface McpServer {
+    handleMessage(msg: unknown): Promise<object | undefined>;
+    handleLine(line: string): Promise<string | undefined>;
+}
+declare function isErrorResult(result: unknown): boolean;
+
+declare const MCP_LATEST_PROTOCOL_VERSION = "2026-07-28";
+declare const MCP_SUPPORTED_PROTOCOL_VERSIONS: readonly ["2026-07-28", "2025-11-25", "2025-06-18", "2025-03-26", "2024-11-05"];
+interface McpServerOptions<TCtx> {
+    name: string;
+    version: string;
+    title?: string;
+    description?: string;
+    instructions?: string;
+    tools: readonly SurfaceTool<TCtx>[];
+    context: () => TCtx | Promise<TCtx>;
+    annotations?: (tool: SurfaceTool<TCtx>) => ToolAnnotations;
+    isErrorResult?: (result: unknown) => boolean;
+}
+declare function createMcpServer<TCtx>(options: McpServerOptions<TCtx>): McpServer;
+
+declare function serveMcpStdio(server: McpServer, options?: {
+    input?: Readable;
+    output?: Writable;
+}): Promise<void>;
+
+declare function createAffinityMcpServer(options?: {
+    db?: AffinityDb;
+    dbPath?: string;
+}): McpServer;
+
+export { type JsonRpcError, type JsonRpcRequest, type JsonRpcResponse, type JsonSchema, MCP_LATEST_PROTOCOL_VERSION, MCP_SUPPORTED_PROTOCOL_VERSIONS, type McpServer, type McpServerOptions, type SurfaceTool, type ToolAnnotations, affinityMcpInstructions, createAffinityMcpServer, createMcpServer, isErrorResult, serveAffinityMcp, serveMcpStdio };