@equationalapplications/mcp-server 0.0.0-stage → 7.16.0

package/dist/index.d.mts

@@ -0,0 +1,113 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+
+type OperationId = 'queryMemory' | 'rememberFact' | 'supersedeFact' | 'ingestDocument' | 'createEvent' | 'traverseGraph' | 'listNamespaces' | 'whoami' | 'registerAgentIdentity' | 'oauthToken' | 'oauthRevoke';
+declare const OPERATION_IDS: readonly OperationId[];
+/** memory:admin operations withheld from agents (SynapseTree ruling D3). Never called, never vendored. */
+declare const WITHHELD_OPERATION_IDS: readonly string[];
+interface Operation {
+    operationId: OperationId;
+    method: 'GET' | 'POST';
+    path: string;
+    scope: 'read' | 'read_write' | null;
+    /** Top-level request-body property names (union across oneOf/anyOf/allOf branches). */
+    requestProperties: string[];
+    /** Properties required in every branch. */
+    requiredProperties: string[];
+    queryParameters: string[];
+    pathParameters: string[];
+    acceptsIdempotencyKey: boolean;
+}
+declare const OPERATIONS: Readonly<Record<OperationId, Operation>>;
+declare const CONTRACT_INFO: {
+    version: string;
+    operations: string[];
+};
+
+declare const DEFAULT_BASE_URL = "https://api.synapsetree.dev";
+interface ClientOptions {
+    /** Optional only so `auth --email` can register and poll; every other operation needs it. */
+    apiKey?: string;
+    baseUrl: string;
+    userAgent: string;
+    fetch?: typeof fetch;
+    sleep?: (ms: number) => Promise<void>;
+    random?: () => number;
+}
+interface CallInput {
+    path?: Record<string, string>;
+    query?: Record<string, string | number | boolean | undefined>;
+    body?: Record<string, unknown>;
+    form?: Record<string, string | undefined>;
+    timeoutMs?: number;
+}
+interface CallResult<T> {
+    status: number;
+    data: T;
+    requestId?: string;
+    rateLimit?: string;
+    rateLimitPolicy?: string;
+    idempotentReplayed: boolean;
+}
+declare class SynapseTreeClient {
+    readonly baseUrl: string;
+    private readonly apiKey?;
+    private readonly userAgent;
+    private readonly fetchImpl;
+    private readonly sleep;
+    private readonly random;
+    constructor(opts: ClientOptions);
+    get hasKey(): boolean;
+    call<T = unknown>(opId: OperationId, input?: CallInput): Promise<CallResult<T>>;
+    private send;
+}
+
+interface SynapseTreeErrorInit {
+    status: number;
+    code: string;
+    detail?: string;
+    requestId?: string;
+    retryAfterSeconds?: number;
+}
+/** A SynapseTree API error (problem+json, an OAuth error body, or a gateway rejection). */
+declare class SynapseTreeError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly detail?: string;
+    readonly requestId?: string;
+    readonly retryAfterSeconds?: number;
+    constructor(init: SynapseTreeErrorInit);
+}
+/** A local mistake: missing configuration or bad input. Never an HTTP failure. */
+declare class UsageError extends Error {
+    constructor(message: string);
+}
+/** One paragraph a model can act on. Never throws. */
+declare function toolErrorText(err: unknown): string;
+
+interface ToolContext {
+    client: SynapseTreeClient;
+    defaultNamespace?: string;
+}
+interface ToolDefinition<S extends z.ZodObject<z.ZodRawShape> = z.ZodObject<z.ZodRawShape>> {
+    name: string;
+    /** The text the model reads. Spec §8 wording is verbatim. */
+    description: string;
+    operation: OperationId;
+    inputSchema: S;
+    handler: (input: z.output<S>, ctx: ToolContext) => Promise<unknown>;
+}
+
+declare const SERVER_NAME = "synapsetree";
+/** Registers exactly the eight tools (spec §8). No resources, prompts, or sampling. */
+declare function createServer(ctx: ToolContext): McpServer;
+
+/** The only place tools are enumerated. Order is the spec §8 table. Adding an entry is a spec amendment (R4). */
+declare const TOOLS: readonly ToolDefinition[];
+declare const TOOL_NAMES: readonly string[];
+
+/** Injected by tsup `define` at build time; `0.0.0-dev` under vitest and tsc. */
+declare const VERSION: string;
+
+export { CONTRACT_INFO, DEFAULT_BASE_URL, OPERATIONS, OPERATION_IDS, SERVER_NAME, SynapseTreeClient, SynapseTreeError, TOOLS, TOOL_NAMES, UsageError, VERSION, WITHHELD_OPERATION_IDS, createServer, toolErrorText };
+export type { CallInput, CallResult, ClientOptions, Operation, OperationId, ToolContext, ToolDefinition };

package/dist/index.d.ts

@@ -0,0 +1,113 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+
+type OperationId = 'queryMemory' | 'rememberFact' | 'supersedeFact' | 'ingestDocument' | 'createEvent' | 'traverseGraph' | 'listNamespaces' | 'whoami' | 'registerAgentIdentity' | 'oauthToken' | 'oauthRevoke';
+declare const OPERATION_IDS: readonly OperationId[];
+/** memory:admin operations withheld from agents (SynapseTree ruling D3). Never called, never vendored. */
+declare const WITHHELD_OPERATION_IDS: readonly string[];
+interface Operation {
+    operationId: OperationId;
+    method: 'GET' | 'POST';
+    path: string;
+    scope: 'read' | 'read_write' | null;
+    /** Top-level request-body property names (union across oneOf/anyOf/allOf branches). */
+    requestProperties: string[];
+    /** Properties required in every branch. */
+    requiredProperties: string[];
+    queryParameters: string[];
+    pathParameters: string[];
+    acceptsIdempotencyKey: boolean;
+}
+declare const OPERATIONS: Readonly<Record<OperationId, Operation>>;
+declare const CONTRACT_INFO: {
+    version: string;
+    operations: string[];
+};
+
+declare const DEFAULT_BASE_URL = "https://api.synapsetree.dev";
+interface ClientOptions {
+    /** Optional only so `auth --email` can register and poll; every other operation needs it. */
+    apiKey?: string;
+    baseUrl: string;
+    userAgent: string;
+    fetch?: typeof fetch;
+    sleep?: (ms: number) => Promise<void>;
+    random?: () => number;
+}
+interface CallInput {
+    path?: Record<string, string>;
+    query?: Record<string, string | number | boolean | undefined>;
+    body?: Record<string, unknown>;
+    form?: Record<string, string | undefined>;
+    timeoutMs?: number;
+}
+interface CallResult<T> {
+    status: number;
+    data: T;
+    requestId?: string;
+    rateLimit?: string;
+    rateLimitPolicy?: string;
+    idempotentReplayed: boolean;
+}
+declare class SynapseTreeClient {
+    readonly baseUrl: string;
+    private readonly apiKey?;
+    private readonly userAgent;
+    private readonly fetchImpl;
+    private readonly sleep;
+    private readonly random;
+    constructor(opts: ClientOptions);
+    get hasKey(): boolean;
+    call<T = unknown>(opId: OperationId, input?: CallInput): Promise<CallResult<T>>;
+    private send;
+}
+
+interface SynapseTreeErrorInit {
+    status: number;
+    code: string;
+    detail?: string;
+    requestId?: string;
+    retryAfterSeconds?: number;
+}
+/** A SynapseTree API error (problem+json, an OAuth error body, or a gateway rejection). */
+declare class SynapseTreeError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly detail?: string;
+    readonly requestId?: string;
+    readonly retryAfterSeconds?: number;
+    constructor(init: SynapseTreeErrorInit);
+}
+/** A local mistake: missing configuration or bad input. Never an HTTP failure. */
+declare class UsageError extends Error {
+    constructor(message: string);
+}
+/** One paragraph a model can act on. Never throws. */
+declare function toolErrorText(err: unknown): string;
+
+interface ToolContext {
+    client: SynapseTreeClient;
+    defaultNamespace?: string;
+}
+interface ToolDefinition<S extends z.ZodObject<z.ZodRawShape> = z.ZodObject<z.ZodRawShape>> {
+    name: string;
+    /** The text the model reads. Spec §8 wording is verbatim. */
+    description: string;
+    operation: OperationId;
+    inputSchema: S;
+    handler: (input: z.output<S>, ctx: ToolContext) => Promise<unknown>;
+}
+
+declare const SERVER_NAME = "synapsetree";
+/** Registers exactly the eight tools (spec §8). No resources, prompts, or sampling. */
+declare function createServer(ctx: ToolContext): McpServer;
+
+/** The only place tools are enumerated. Order is the spec §8 table. Adding an entry is a spec amendment (R4). */
+declare const TOOLS: readonly ToolDefinition[];
+declare const TOOL_NAMES: readonly string[];
+
+/** Injected by tsup `define` at build time; `0.0.0-dev` under vitest and tsc. */
+declare const VERSION: string;
+
+export { CONTRACT_INFO, DEFAULT_BASE_URL, OPERATIONS, OPERATION_IDS, SERVER_NAME, SynapseTreeClient, SynapseTreeError, TOOLS, TOOL_NAMES, UsageError, VERSION, WITHHELD_OPERATION_IDS, createServer, toolErrorText };
+export type { CallInput, CallResult, ClientOptions, Operation, OperationId, ToolContext, ToolDefinition };