@outfitter/mcp 0.3.0 → 0.4.1

package/dist/shared/@outfitter/mcp-a0cgfsnw.d.ts

@@ -0,0 +1,8 @@
+import { ToolDefinition } from "./mcp-h2twz77x";
+import { ActionRegistry, ActionSurface, AnyActionSpec } from "@outfitter/contracts";
+interface BuildMcpToolsOptions {
+	readonly includeSurfaces?: readonly ActionSurface[];
+}
+type ActionSource = ActionRegistry | readonly AnyActionSpec[];
+declare function buildMcpTools(source: ActionSource, options?: BuildMcpToolsOptions): ToolDefinition<unknown, unknown>[];
+export { BuildMcpToolsOptions, buildMcpTools };

package/dist/shared/@outfitter/mcp-cqpyer9m.d.ts

@@ -0,0 +1,27 @@
+/**
+* @outfitter/mcp - Logging Bridge
+*
+* Maps Outfitter log levels to MCP log levels for
+* server-to-client log message notifications.
+*
+* @packageDocumentation
+*/
+/**
+* MCP log levels as defined in the MCP specification.
+* Ordered from least to most severe.
+*/
+type McpLogLevel = "debug" | "info" | "notice" | "warning" | "error" | "critical" | "alert" | "emergency";
+/**
+* Outfitter log levels.
+*/
+type OutfitterLogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+/**
+* Map an Outfitter log level to the corresponding MCP log level.
+*/
+declare function mapLogLevelToMcp(level: OutfitterLogLevel): McpLogLevel;
+/**
+* Check whether a message at the given level should be emitted
+* based on the client-requested threshold.
+*/
+declare function shouldEmitLog(messageLevel: McpLogLevel, threshold: McpLogLevel): boolean;
+export { McpLogLevel, mapLogLevelToMcp, shouldEmitLog };

package/dist/shared/@outfitter/mcp-dwd800vf.d.ts

@@ -0,0 +1,96 @@
+import { ToolDefinition } from "./mcp-h2twz77x";
+import { HandlerContext, OutfitterError } from "@outfitter/contracts";
+import { Result } from "@outfitter/contracts";
+type DocsSection = "overview" | "tools" | "examples" | "schemas";
+interface DocsToolInput {
+	section?: DocsSection | undefined;
+}
+interface DocsToolEntry {
+	name: string;
+	summary?: string;
+	examples?: Array<{
+		input: Record<string, unknown>;
+		description?: string;
+	}>;
+}
+interface DocsToolResponse {
+	overview?: string;
+	tools?: DocsToolEntry[];
+	examples?: Array<{
+		name?: string;
+		description?: string;
+		input?: Record<string, unknown>;
+		output?: unknown;
+	}>;
+	schemas?: Record<string, unknown>;
+}
+interface DocsToolOptions {
+	/** Optional override for the docs tool description. */
+	description?: string;
+	/** Static docs payload (used when getDocs is not provided). */
+	docs?: DocsToolResponse;
+	/** Dynamic docs provider. */
+	getDocs?: (section?: DocsSection) => DocsToolResponse | Promise<DocsToolResponse>;
+}
+declare function defineDocsTool(options?: DocsToolOptions): ToolDefinition<DocsToolInput, DocsToolResponse>;
+type ConfigAction = "get" | "set" | "list";
+interface ConfigToolInput {
+	action: ConfigAction;
+	key?: string | undefined;
+	value?: unknown | undefined;
+}
+interface ConfigToolResponse {
+	action: ConfigAction;
+	key?: string;
+	value?: unknown;
+	found?: boolean;
+	config?: Record<string, unknown>;
+}
+interface ConfigStore {
+	get(key: string): {
+		value: unknown;
+		found: boolean;
+	} | Promise<{
+		value: unknown;
+		found: boolean;
+	}>;
+	set(key: string, value: unknown): void | Promise<void>;
+	list(): Record<string, unknown> | Promise<Record<string, unknown>>;
+}
+interface ConfigToolOptions {
+	/** Optional override for the config tool description. */
+	description?: string;
+	/** Initial config values when using the default in-memory store. */
+	initial?: Record<string, unknown>;
+	/** Custom config store implementation. */
+	store?: ConfigStore;
+}
+declare function defineConfigTool(options?: ConfigToolOptions): ToolDefinition<ConfigToolInput, ConfigToolResponse>;
+interface QueryToolInput {
+	q?: string | undefined;
+	query?: string | undefined;
+	limit?: number | undefined;
+	cursor?: string | undefined;
+	filters?: Record<string, unknown> | undefined;
+}
+interface QueryToolResponse<T = unknown> {
+	results: T[];
+	nextCursor?: string;
+	_meta?: Record<string, unknown>;
+}
+interface QueryToolOptions<T = unknown> {
+	/** Optional override for the query tool description. */
+	description?: string;
+	/** Custom query handler implementation. */
+	handler?: (input: NormalizedQueryInput, ctx: HandlerContext) => Promise<Result<QueryToolResponse<T>, OutfitterError>>;
+}
+declare function defineQueryTool<T = unknown>(options?: QueryToolOptions<T>): ToolDefinition<QueryToolInput, QueryToolResponse<T>>;
+interface CoreToolsOptions {
+	docs?: DocsToolOptions;
+	config?: ConfigToolOptions;
+	query?: QueryToolOptions;
+}
+type NormalizedQueryInput = Required<Pick<QueryToolInput, "q">> & Omit<QueryToolInput, "q">;
+type CoreToolDefinition = ToolDefinition<DocsToolInput, DocsToolResponse> | ToolDefinition<ConfigToolInput, ConfigToolResponse> | ToolDefinition<QueryToolInput, QueryToolResponse>;
+declare function createCoreTools(options?: CoreToolsOptions): CoreToolDefinition[];
+export { DocsSection, DocsToolInput, DocsToolEntry, DocsToolResponse, DocsToolOptions, defineDocsTool, ConfigAction, ConfigToolInput, ConfigToolResponse, ConfigStore, ConfigToolOptions, defineConfigTool, QueryToolInput, QueryToolResponse, QueryToolOptions, defineQueryTool, CoreToolsOptions, NormalizedQueryInput, CoreToolDefinition, createCoreTools };

package/dist/shared/@outfitter/mcp-fjtxsa0x.js

@@ -0,0 +1,36 @@
+// @bun
+// packages/mcp/src/logging.ts
+var MCP_LEVEL_ORDER = [
+  "debug",
+  "info",
+  "notice",
+  "warning",
+  "error",
+  "critical",
+  "alert",
+  "emergency"
+];
+function mapLogLevelToMcp(level) {
+  switch (level) {
+    case "trace":
+    case "debug":
+      return "debug";
+    case "info":
+      return "info";
+    case "warn":
+      return "warning";
+    case "error":
+      return "error";
+    case "fatal":
+      return "emergency";
+    default: {
+      const _exhaustiveCheck = level;
+      return _exhaustiveCheck;
+    }
+  }
+}
+function shouldEmitLog(messageLevel, threshold) {
+  return MCP_LEVEL_ORDER.indexOf(messageLevel) >= MCP_LEVEL_ORDER.indexOf(threshold);
+}
+
+export { mapLogLevelToMcp, shouldEmitLog };