@tpsdev-ai/flair-mcp 0.53.0 → 0.54.2

package/dist/tool-descriptors/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Transport-agnostic MCP tool descriptors (flair#1580).
+ *
+ * Pure data + types: name, description, inputSchema, output shape, and
+ * reviewed surface flags. No Harper, no FlairClient, no Zod, no HTTP.
+ *
+ * The server TOOLS registry binds each native descriptor to its Harper impl.
+ * The flair-mcp stdio adapter binds each stdio descriptor to a FlairClient
+ * call. Both tool sets are DERIVED from this list — a new descriptor appears
+ * on every surface that lists it, with zero hand-wiring.
+ */
+/** JSON Schema object used as MCP tools/list inputSchema. */
+export interface JsonSchemaObject {
+    type: "object";
+    properties: Record<string, JsonSchemaProperty>;
+    required?: string[];
+}
+export interface JsonSchemaProperty {
+    type?: string;
+    description?: string;
+    enum?: string[];
+    items?: {
+        type?: string;
+    };
+    default?: unknown;
+}
+/** MCP tool descriptor as returned by tools/list. */
+export interface McpToolDef {
+    name: string;
+    description: string;
+    inputSchema: JsonSchemaObject;
+    annotations?: Record<string, unknown>;
+}
+/**
+ * One MCP-facing tool. `native` / `stdio` default true — omit both and the
+ * tool appears on every surface. Set false for a reviewed one-sided tool
+ * (the #1578 exemption list is derived from these flags).
+ */
+export interface ToolDescriptor {
+    name: string;
+    description: string;
+    inputSchema: JsonSchemaObject;
+    /** One-line output shape (MCP metadata). Native conformance contracts pin this as `summary`. */
+    outputShape: string;
+    annotations?: Record<string, unknown>;
+    /** When false, native /mcp does not bind this tool. Default true. */
+    native?: boolean;
+    /** When false, the stdio adapter does not bind this tool. Default true. */
+    stdio?: boolean;
+    /** Stdio-only description when the HTTP path differs from native /mcp policy. */
+    stdioDescription?: string;
+    /** Properties advertised on native /mcp only (reviewed, e.g. flair#1579). */
+    stdioOmitProperties?: readonly string[];
+    /** Properties advertised on the stdio adapter only (reviewed). */
+    stdioExtraProperties?: Record<string, JsonSchemaProperty>;
+}
+export declare function isNativeTool(d: ToolDescriptor): boolean;
+export declare function isStdioTool(d: ToolDescriptor): boolean;
+export declare function toMcpToolDef(d: ToolDescriptor): McpToolDef;
+/** Native tools/list def, minus reviewed stdio-only omissions. */
+export declare function toStdioMcpToolDef(d: ToolDescriptor): McpToolDef;
+export declare function descriptorNames(descriptors: readonly ToolDescriptor[]): string[];
+export declare const TOOL_DESCRIPTORS: readonly ToolDescriptor[];
+export declare const NATIVE_TOOL_DESCRIPTORS: readonly ToolDescriptor[];
+export declare const STDIO_TOOL_DESCRIPTORS: readonly ToolDescriptor[];
+/** Derived #1578 exemption list — one-sided by construction, not hand-synced. */
+export declare const SURFACE_EXEMPTIONS: {
+    readonly registryOnly: string[];
+    readonly adapterOnly: string[];
+};