@burdenoff/mcp-libs 2026.1014.4 → 2026.1026.1

package/dist/core/index.d.ts

@@ -1,59 +1,14 @@
-export { A as AuthMethod, a as AuthStore, B as BuildContextOptions, C as ConfigStore, E as Environment, G as GqlClient, c as GqlClients, d as LogContext, e as LogFormat, f as LogLevel, L as Logger, g as LoggerOptions, h as McpConfig, M as McpContext, P as ProductDefaults, i as ProgressFn, S as StoredAuth, b as buildContext, j as createAuthStore, k as createConfigStore, l as createGqlClients, m as createLogger, n as createProgress, o as extractGqlErrorMessage } from '../context-DGO4h-Pd.js';
-export { C as CreateMcpServerOptions, M as McpServerHandle, h as TOOL_NAME_LIMIT, i as ToolAnnotations, k as ToolGovernanceOptions, T as ToolHandler, a as ToolMeta, b as ToolMetadata, c as ToolResult, l as ToolTextContent, d as createMcpServer, e as errorResult, n as inferDestructiveHint, o as inferReadOnlyHint, j as jsonResult, m as mcpPromptName, f as mcpResourceUri, g as mcpToolName, r as registerTool, t as textResult, w as wrapServerWithToolGovernance } from '../tool-name-BFdQwYrv.js';
-export { C as CircularDependencyError, M as McpAuthError, a as McpCapabilities, b as McpInternalError, c as McpModule, d as McpUserError, f as MissingDependencyError, e as ModuleRegistration, S as ServerManifest, s as sortModules, t as toServerCapabilities, u as unionCapabilities } from '../module-VpgjAf8m.js';
-import '@modelcontextprotocol/sdk/server/mcp.js';
-import 'graphql-request';
-import 'zod';
-
-interface DeviceCodeResponse {
-    deviceCode: string;
-    userCode: string;
-    verificationUri: string;
-    verificationUriComplete: string | null;
-    expiresIn: number;
-    interval: number;
-}
-interface DeviceCodeTokenResult {
-    accessToken: string;
-    refreshToken: string;
-    expiresIn: number;
-}
-interface ClientCredentialsResult {
-    accessToken: string;
-    expiresIn: number;
-    scopes: string[];
-}
-interface OIDCConfig {
-    oidcIssuer: string;
-    clientId: string;
-}
-declare function startDeviceCodeFlow(config: OIDCConfig): Promise<DeviceCodeResponse>;
-type DeviceTokenPollResult = {
-    status: 'authenticated';
-    tokens: DeviceCodeTokenResult;
-} | {
-    status: 'pending';
-} | {
-    status: 'slow_down';
-    newInterval: number;
-} | {
-    status: 'expired';
-} | {
-    status: 'denied';
-};
-declare function pollDeviceTokenOnce(deviceCode: string, interval: number, config: OIDCConfig): Promise<DeviceTokenPollResult>;
-declare function clientCredentialsFlow(globalEndpoint: string, clientId: string, clientSecret: string, scopes?: string[]): Promise<ClientCredentialsResult>;
-declare function issueWorkspaceToken(workspaceEndpoint: string, authToken: string, workspaceId: string, organizationId: string): Promise<{
-    token: string;
-    expiresAt: string;
-    scopes: string[];
-}>;
-declare function fetchWorkspaces(globalEndpoint: string, authToken: string): Promise<Array<{
-    id: string;
-    name: string;
-    slug: string;
-    tenantId: string;
-    organizationId: string;
-}>>;
-
-export { type ClientCredentialsResult, type DeviceCodeResponse, type DeviceCodeTokenResult, type DeviceTokenPollResult, type OIDCConfig, clientCredentialsFlow, fetchWorkspaces, issueWorkspaceToken, pollDeviceTokenOnce, startDeviceCodeFlow };
+export { buildContext, type McpContext, type BuildContextOptions, type Environment, } from './context.js';
+export { createMcpServer, type CreateMcpServerOptions, type McpServerHandle } from './server.js';
+export { sortModules, MissingDependencyError, CircularDependencyError, type McpModule, type ModuleRegistration, type ServerManifest, } from './module.js';
+export { McpUserError, McpAuthError, McpInternalError } from './errors.js';
+export { createLogger, type Logger, type LoggerOptions, type LogLevel, type LogFormat, type LogContext, } from './logger.js';
+export { jsonResult, textResult, errorResult, registerTool, type ToolResult, type ToolTextContent, type ToolMeta, type ToolMetadata, type ToolHandler, } from './result.js';
+export { mcpToolName, mcpResourceUri, mcpPromptName, TOOL_NAME_LIMIT, inferDestructiveHint, inferReadOnlyHint, DESTRUCTIVE_NAME_VERBS, } from './tool-name.js';
+export { wrapServerWithToolGovernance, withToolAnnotations, type ToolAnnotationResolver, type ToolAnnotations, type ToolGovernanceOptions, } from './tool-governance.js';
+export { unionCapabilities, toServerCapabilities, type McpCapabilities } from './capabilities.js';
+export { createProgress, type ProgressFn } from './progress.js';
+export { createAuthStore, type AuthStore, type StoredAuth, type AuthMethod } from './auth/store.js';
+export { startDeviceCodeFlow, pollDeviceTokenOnce, clientCredentialsFlow, issueWorkspaceToken, fetchWorkspaces, type DeviceCodeResponse, type DeviceCodeTokenResult, type DeviceTokenPollResult, type ClientCredentialsResult, type OIDCConfig, } from './auth/device-code.js';
+export { createConfigStore, type ConfigStore, type McpConfig, type ProductDefaults, } from './config/store.js';
+export { createGqlClients, extractGqlErrorMessage, type GqlClient, type GqlClients, } from './gql/client.js';

package/dist/core/index.js

@@ -1,3 +1,3 @@
-export { CircularDependencyError, McpAuthError, McpInternalError, McpUserError, MissingDependencyError, TOOL_NAME_LIMIT, buildContext, clientCredentialsFlow, createAuthStore, createConfigStore, createGqlClients, createLogger, createMcpServer, createProgress, errorResult, extractGqlErrorMessage, fetchWorkspaces, inferDestructiveHint, inferReadOnlyHint, issueWorkspaceToken, jsonResult, mcpPromptName, mcpResourceUri, mcpToolName, pollDeviceTokenOnce, registerTool, sortModules, startDeviceCodeFlow, textResult, toServerCapabilities, unionCapabilities, wrapServerWithToolGovernance } from '../chunk-G76DKEPI.js';
+export { CircularDependencyError, DESTRUCTIVE_NAME_VERBS, McpAuthError, McpInternalError, McpUserError, MissingDependencyError, TOOL_NAME_LIMIT, buildContext, clientCredentialsFlow, createAuthStore, createConfigStore, createGqlClients, createLogger, createMcpServer, createProgress, errorResult, extractGqlErrorMessage, fetchWorkspaces, inferDestructiveHint, inferReadOnlyHint, issueWorkspaceToken, jsonResult, mcpPromptName, mcpResourceUri, mcpToolName, pollDeviceTokenOnce, registerTool, sortModules, startDeviceCodeFlow, textResult, toServerCapabilities, unionCapabilities, withToolAnnotations, wrapServerWithToolGovernance } from '../chunk-FHXCNP2U.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/core/logger.d.ts

@@ -0,0 +1,18 @@
+export type LogLevel = 'error' | 'warn' | 'info' | 'debug';
+export type LogFormat = 'json' | 'text';
+export interface LogContext {
+    [key: string]: unknown;
+}
+export interface Logger {
+    error(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    debug(message: string, context?: LogContext): void;
+    setLevel(level: LogLevel): void;
+    getLevel(): LogLevel;
+}
+export interface LoggerOptions {
+    level?: LogLevel;
+    format?: LogFormat;
+}
+export declare function createLogger(opts?: LoggerOptions): Logger;

package/dist/core/module.d.ts

@@ -0,0 +1,33 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpContext } from './context.js';
+import type { McpCapabilities } from './capabilities.js';
+import { McpInternalError } from './errors.js';
+export interface ModuleRegistration {
+    tools: readonly string[];
+    resources: readonly string[];
+    prompts: readonly string[];
+}
+export interface McpModule {
+    readonly id: string;
+    readonly version: string;
+    readonly displayName: string;
+    readonly dependsOn?: readonly string[];
+    readonly capabilities?: McpCapabilities;
+    register(server: McpServer, ctx: McpContext): ModuleRegistration;
+}
+export declare class MissingDependencyError extends McpInternalError {
+    constructor(moduleId: string, missingDep: string);
+}
+export declare class CircularDependencyError extends McpInternalError {
+    constructor(cycle: readonly string[]);
+}
+export declare function sortModules(modules: readonly McpModule[]): McpModule[];
+export interface ServerManifest {
+    modules: readonly {
+        id: string;
+        version: string;
+    }[];
+    tools: readonly string[];
+    resources: readonly string[];
+    prompts: readonly string[];
+}

package/dist/core/progress.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export type ProgressFn = (token: string | number | undefined, current: number, total?: number, message?: string) => void;
+export declare function createProgress(serverRef: {
+    current: McpServer | null;
+}): ProgressFn;

package/dist/core/result.d.ts

@@ -0,0 +1,29 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ZodRawShape } from 'zod';
+import type { McpContext } from './context.js';
+import type { ToolAnnotations } from './tool-governance.js';
+export interface ToolTextContent {
+    type: 'text';
+    text: string;
+    [k: string]: unknown;
+}
+export interface ToolResult {
+    content: ToolTextContent[];
+    isError?: boolean;
+    structuredContent?: Record<string, unknown>;
+    [k: string]: unknown;
+}
+export interface ToolMeta {
+    progressToken?: string | number;
+}
+export declare function jsonResult(data: unknown, structured?: Record<string, unknown>): ToolResult;
+export declare function textResult(text: string): ToolResult;
+export declare function errorResult(message: string, hint?: string): ToolResult;
+export interface ToolMetadata {
+    title: string;
+    description: string;
+    inputSchema?: ZodRawShape;
+    annotations?: ToolAnnotations;
+}
+export type ToolHandler<TArgs = Record<string, unknown>> = (args: TArgs, ctx: McpContext, meta: ToolMeta) => Promise<unknown>;
+export declare function registerTool<TArgs extends Record<string, unknown>>(server: McpServer, ctx: McpContext, name: string, metadata: ToolMetadata, handler: ToolHandler<TArgs>): void;

package/dist/core/server.d.ts

@@ -0,0 +1,15 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpContext } from './context.js';
+import { type McpModule, type ServerManifest } from './module.js';
+import { type McpCapabilities } from './capabilities.js';
+export interface CreateMcpServerOptions {
+    name: string;
+    version: string;
+    extraCapabilities?: McpCapabilities;
+    enforceDestructiveConfirmation?: boolean;
+}
+export interface McpServerHandle {
+    server: McpServer;
+    manifest: ServerManifest;
+}
+export declare function createMcpServer(ctx: McpContext, modules: readonly McpModule[], opts: CreateMcpServerOptions): McpServerHandle;

package/dist/core/tool-governance.d.ts

@@ -0,0 +1,14 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export interface ToolAnnotations {
+    title?: string;
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+}
+export interface ToolGovernanceOptions {
+    enforceDestructiveConfirmation?: boolean;
+}
+export declare function wrapServerWithToolGovernance(server: McpServer, options?: ToolGovernanceOptions): McpServer;
+export type ToolAnnotationResolver = (toolName: string) => ToolAnnotations | undefined;
+export declare function withToolAnnotations<T>(server: McpServer, resolve: ToolAnnotationResolver, register: () => T): T;

package/dist/core/tool-name.d.ts

@@ -0,0 +1,7 @@
+export declare function mcpToolName(productName: string, ...parts: string[]): string;
+export declare function mcpResourceUri(productName: string, ...parts: string[]): string;
+export declare function mcpPromptName(productName: string, ...parts: string[]): string;
+export declare const TOOL_NAME_LIMIT = 63;
+export declare const DESTRUCTIVE_NAME_VERBS: readonly ["delete", "destroy", "erase", "kill", "purge", "remove", "reset", "revoke", "rotate", "stop", "terminate", "uninstall", "wipe"];
+export declare function inferDestructiveHint(toolName: string): boolean;
+export declare function inferReadOnlyHint(toolName: string): boolean;

package/dist/index.cjs

@@ -703,7 +703,25 @@ function mcpPromptName(productName, ...parts) {
   }
   return [productName, ...parts].filter(Boolean).join("-");
 }
-var DESTRUCTIVE_NAME_SEGMENT = /(?:^|_)delete(?:_|$)/i;
+var DESTRUCTIVE_NAME_VERBS = [
+  "delete",
+  "destroy",
+  "erase",
+  "kill",
+  "purge",
+  "remove",
+  "reset",
+  "revoke",
+  "rotate",
+  "stop",
+  "terminate",
+  "uninstall",
+  "wipe"
+];
+var DESTRUCTIVE_NAME_SEGMENT = new RegExp(
+  `(?:^|_)(?:${DESTRUCTIVE_NAME_VERBS.join("|")})(?:_|$)`,
+  "i"
+);
 var READ_ONLY_NAME_SEGMENT = /(?:^|_)(?:list|get|search|check|read|count|stats|by_date)(?:_|$)/i;
 function inferDestructiveHint(toolName) {
   return DESTRUCTIVE_NAME_SEGMENT.test(toolName);