@uluops/registry-mcp 0.1.0

package/dist/types/schemas.js

@@ -0,0 +1,65 @@
+/**
+ * Shared Zod schemas for MCP input validation
+ *
+ * These define the enum values accepted by registry tools.
+ * MCP uses snake_case field names; normalizeKeys converts to camelCase for the SDK.
+ */
+import { z } from 'zod';
+/** Registry definition types: agent, command, workflow, or pipeline. */
+export const DefinitionTypeSchema = z.enum(['agent', 'command', 'workflow', 'pipeline']);
+/** Lifecycle statuses for definitions. */
+export const DefinitionStatusSchema = z.enum(['draft', 'published', 'deprecated', 'archived']);
+/** Knowledge domain categories for definitions. */
+export const DomainSchema = z.enum([
+    'software',
+    'security',
+    'compliance',
+    'legal',
+    'medical',
+    'financial',
+    'scientific',
+    'content',
+    'general',
+    'cognitive-lens',
+]);
+/** Agent behavioral subtypes. */
+export const AgentTypeSchema = z.enum(['validator', 'executor', 'analyst', 'generator', 'explorer', 'forecaster']);
+/** Access control levels for definitions. */
+export const VisibilitySchema = z.enum(['private', 'unlisted', 'public']);
+/** Sortable fields for list queries. */
+export const SortFieldSchema = z.enum(['name', 'createdAt', 'updatedAt', 'executionCount']);
+/** Sort direction. */
+export const SortOrderSchema = z.enum(['asc', 'desc']);
+/** AI model pricing/capability tiers. */
+export const ModelTierSchema = z.enum(['budget', 'standard', 'premium', 'reasoning']);
+/** AI model availability statuses. */
+export const ModelStatusSchema = z.enum(['available', 'preview', 'deprecated']);
+/** Quality/provenance tiers for definitions. */
+export const TierSchema = z.enum(['user', 'org', 'pro']);
+/** Subscription tiers for content gating. */
+export const SubscriptionTierSchema = z.enum(['free', 'hobbyist', 'plus', 'pro', 'enterprise']);
+/** Semantic version change types for definition updates. */
+export const ChangeTypeSchema = z.enum(['major', 'minor', 'patch']);
+/** Authorship provenance classification. */
+export const AuthorshipTypeSchema = z.enum(['human', 'agent', 'collaborative', 'automated']);
+/** Contributor role in definition authorship. */
+export const ContributorRoleSchema = z.enum(['author', 'optimizer', 'reviewer', 'editor', 'publisher']);
+/** Actor type — human or agent. */
+export const ActorTypeSchema = z.enum(['human', 'agent']);
+/** A single contributor to a definition's authorship. */
+export const ContributorSchema = z.object({
+    id: z.string().min(1).max(100),
+    role: ContributorRoleSchema,
+    type: ActorTypeSchema,
+    name: z.string().max(200).optional(),
+    agent_name: z.string().max(200).optional(),
+    contributed_at: z.string().optional(),
+});
+/** Full provenance record for a definition. */
+export const ProvenanceInputSchema = z.object({
+    authorship_type: AuthorshipTypeSchema,
+    contributors: z.array(ContributorSchema).min(1).max(50),
+    dialectic_rounds: z.number().int().nonnegative().optional(),
+    optimization_run_id: z.string().max(100).optional(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/types/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/types/schemas.ts"],"names":[],"mappings":"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"}

package/dist/types/server.d.ts

@@ -0,0 +1,29 @@
+/**
+ * MCP Server interface types
+ */
+import type { ZodRawShape } from 'zod';
+import type { McpToolResponse } from './mcp.js';
+export type ToolHandler = (args: unknown) => Promise<McpToolResponse>;
+export interface ResourceContent {
+    uri: string;
+    mimeType?: string;
+    text?: string;
+    blob?: string;
+}
+export interface ResourceResponse {
+    contents: ResourceContent[];
+}
+export type ResourceHandler = () => Promise<ResourceResponse>;
+export interface ResourceMetadata {
+    description?: string;
+    mimeType?: string;
+}
+export interface McpServerToolRegistration {
+    tool: (name: string, description: string, schema: ZodRawShape, handler: ToolHandler) => void;
+}
+export interface McpServerResourceRegistration {
+    resource: (name: string, uri: string, metadataOrHandler: ResourceMetadata | ResourceHandler, handler?: ResourceHandler) => void;
+}
+export interface McpServer extends McpServerToolRegistration, McpServerResourceRegistration {
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/types/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/types/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;CAC9F;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,CACR,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,iBAAiB,EAAE,gBAAgB,GAAG,eAAe,EACrD,OAAO,CAAC,EAAE,eAAe,KACtB,IAAI,CAAC;CACX;AAED,MAAM,WAAW,SAAU,SAAQ,yBAAyB,EAAE,6BAA6B;CAAG"}

package/dist/types/server.js

@@ -0,0 +1,5 @@
+/**
+ * MCP Server interface types
+ */
+export {};
+//# sourceMappingURL=server.js.map

package/dist/types/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/types/server.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Structured logger with optional file output
+ *
+ * Logs to stderr (for MCP compatibility) and optionally to files.
+ */
+import type { LogLevel } from '../types/index.js';
+export interface LoggerConfig {
+    level: LogLevel;
+    enableFileLogging?: boolean;
+    logDir?: string;
+}
+export interface Logger {
+    debug: (message: string, context?: Record<string, unknown>) => void;
+    info: (message: string, context?: Record<string, unknown>) => void;
+    warn: (message: string, context?: Record<string, unknown>) => void;
+    error: (message: string, context?: Record<string, unknown>) => void;
+}
+export declare function createLogger(config: LoggerConfig | LogLevel): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,QAAQ,CAAC;IAChB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACpE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACnE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACnE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACrE;AAsDD,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,MAAM,CAmDpE"}

package/dist/utils/logger.js

@@ -0,0 +1,94 @@
+/**
+ * Structured logger with optional file output
+ *
+ * Logs to stderr (for MCP compatibility) and optionally to files.
+ */
+import { appendFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join, resolve, isAbsolute } from 'node:path';
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+function formatLogEntry(level, message, context) {
+    const entry = {
+        timestamp: new Date().toISOString(),
+        level: level.toUpperCase(),
+        message,
+        ...(context && Object.keys(context).length > 0 ? { context } : {}),
+    };
+    return JSON.stringify(entry);
+}
+function getLogFilePath(logDir) {
+    const date = new Date().toISOString().split('T')[0] ?? 'unknown';
+    return join(logDir, `registry-mcp-${date}.log`);
+}
+/**
+ * Validate that a log directory path is safe to write to.
+ * Rejects paths containing traversal sequences or pointing outside the working tree.
+ */
+function validateLogDir(logDir) {
+    const resolved = resolve(logDir);
+    const cwd = process.cwd();
+    // Reject path traversal patterns
+    if (logDir.includes('..')) {
+        throw new Error(`LOG_DIR must not contain path traversal sequences: ${logDir}`);
+    }
+    // Absolute paths must be under cwd or a well-known logs location
+    if (isAbsolute(logDir) && !resolved.startsWith(cwd) && !resolved.startsWith('/tmp/')) {
+        throw new Error(`LOG_DIR absolute path must be under the working directory or /tmp/: ${logDir}`);
+    }
+    return resolved;
+}
+function ensureLogDir(logDir) {
+    if (!existsSync(logDir)) {
+        mkdirSync(logDir, { recursive: true });
+    }
+}
+export function createLogger(config) {
+    const resolvedConfig = typeof config === 'string' ? { level: config } : config;
+    const { level, enableFileLogging = false, logDir } = resolvedConfig;
+    const minLevel = LOG_LEVELS[level];
+    const rawLogDir = logDir ?? join(process.cwd(), 'logs');
+    const resolvedLogDir = enableFileLogging ? validateLogDir(rawLogDir) : rawLogDir;
+    if (enableFileLogging) {
+        ensureLogDir(resolvedLogDir);
+    }
+    let fileLoggingFailed = false;
+    const log = (logLevel, message, context) => {
+        if (LOG_LEVELS[logLevel] < minLevel) {
+            return;
+        }
+        const formatted = formatLogEntry(logLevel, message, context);
+        console.error(formatted);
+        if (enableFileLogging) {
+            try {
+                const filePath = getLogFilePath(resolvedLogDir);
+                appendFileSync(filePath, formatted + '\n', 'utf-8');
+            }
+            catch (fileError) {
+                if (!fileLoggingFailed) {
+                    fileLoggingFailed = true;
+                    const detail = fileError instanceof Error ? fileError.message : String(fileError);
+                    console.error(formatLogEntry('warn', `File logging failed: ${detail}. Further file log errors suppressed`));
+                }
+            }
+        }
+    };
+    return {
+        debug: (message, context) => {
+            log('debug', message, context);
+        },
+        info: (message, context) => {
+            log('info', message, context);
+        },
+        warn: (message, context) => {
+            log('warn', message, context);
+        },
+        error: (message, context) => {
+            log('error', message, context);
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAgBtD,MAAM,UAAU,GAA6B;IAC3C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,SAAS,cAAc,CACrB,KAAe,EACf,OAAe,EACf,OAAiC;IAEjC,MAAM,KAAK,GAAG;QACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE;QAC1B,OAAO;QACP,GAAG,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,cAAc,CAAC,MAAc;IACpC,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;IACjE,OAAO,IAAI,CAAC,MAAM,EAAE,gBAAgB,IAAI,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,MAAc;IACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,iCAAiC;IACjC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,sDAAsD,MAAM,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,iEAAiE;IACjE,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CACb,uEAAuE,MAAM,EAAE,CAChF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CAAC,MAAc;IAClC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAA+B;IAC1D,MAAM,cAAc,GAAiB,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7F,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC;IACpE,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IACxD,MAAM,cAAc,GAAG,iBAAiB,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjF,IAAI,iBAAiB,EAAE,CAAC;QACtB,YAAY,CAAC,cAAc,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAE9B,MAAM,GAAG,GAAG,CAAC,QAAkB,EAAE,OAAe,EAAE,OAAiC,EAAQ,EAAE;QAC3F,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,QAAQ,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7D,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAEzB,IAAI,iBAAiB,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;gBAChD,cAAc,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;YACtD,CAAC;YAAC,OAAO,SAAkB,EAAE,CAAC;gBAC5B,IAAI,CAAC,iBAAiB,EAAE,CAAC;oBACvB,iBAAiB,GAAG,IAAI,CAAC;oBACzB,MAAM,MAAM,GAAG,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;oBAClF,OAAO,CAAC,KAAK,CACX,cAAc,CAAC,MAAM,EAAE,wBAAwB,MAAM,sCAAsC,CAAC,CAC7F,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,CAAC,OAAe,EAAE,OAAiC,EAAQ,EAAE;YAClE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,EAAE,CAAC,OAAe,EAAE,OAAiC,EAAQ,EAAE;YACjE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,EAAE,CAAC,OAAe,EAAE,OAAiC,EAAQ,EAAE;YACjE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,KAAK,EAAE,CAAC,OAAe,EAAE,OAAiC,EAAQ,EAAE;YAClE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/normalize-keys.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Key normalization utilities for snake_case -> camelCase conversion
+ *
+ * MCP tool inputs use snake_case (matching the MCP protocol convention).
+ * The SDK expects camelCase. This module provides recursive conversion.
+ */
+/**
+ * Recursively convert all object keys from snake_case to camelCase.
+ */
+export declare function normalizeKeys(input: unknown, depth?: number): unknown;
+//# sourceMappingURL=normalize-keys.d.ts.map

package/dist/utils/normalize-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-keys.d.ts","sourceRoot":"","sources":["../../src/utils/normalize-keys.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,OAAO,CAuBhE"}

package/dist/utils/normalize-keys.js

@@ -0,0 +1,41 @@
+/**
+ * Key normalization utilities for snake_case -> camelCase conversion
+ *
+ * MCP tool inputs use snake_case (matching the MCP protocol convention).
+ * The SDK expects camelCase. This module provides recursive conversion.
+ */
+/**
+ * Convert a single snake_case string to camelCase
+ */
+function toCamelCase(str) {
+    return str.replace(/_([a-z0-9])/g, (_, c) => c.toUpperCase());
+}
+const MAX_DEPTH = 20;
+/**
+ * Recursively convert all object keys from snake_case to camelCase.
+ */
+export function normalizeKeys(input, depth = 0) {
+    if (depth > MAX_DEPTH) {
+        // Safety limit to prevent infinite recursion on circular references.
+        // MCP tool inputs are shallow objects (typically 1-3 levels deep).
+        return input;
+    }
+    if (Array.isArray(input)) {
+        return input.map((item) => normalizeKeys(item, depth + 1));
+    }
+    if (input !== null && typeof input === 'object') {
+        const result = {};
+        // SAFETY: Non-null object is guaranteed by the guard above. Object.entries requires
+        // Record<string, unknown> cast since `input` is typed as `object` (no index signature).
+        for (const [key, value] of Object.entries(input)) {
+            const camelKey = toCamelCase(key);
+            if (camelKey === '__proto__' || camelKey === 'constructor' || camelKey === 'prototype') {
+                continue;
+            }
+            result[camelKey] = normalizeKeys(value, depth + 1);
+        }
+        return result;
+    }
+    return input;
+}
+//# sourceMappingURL=normalize-keys.js.map

package/dist/utils/normalize-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-keys.js","sourceRoot":"","sources":["../../src/utils/normalize-keys.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,KAAK,GAAG,CAAC;IACrD,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;QACtB,qEAAqE;QACrE,mEAAmE;QACnE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,oFAAoF;QACpF,wFAAwF;QACxF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YAC5E,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,aAAa,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;gBACvF,SAAS;YACX,CAAC;YACD,MAAM,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/read-yaml-file.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Read YAML file from disk (sync) and resolve yaml/file_path input.
+ *
+ * Used by tools that accept `file_path` as an alternative to inline `yaml`.
+ * Sync because `preProcess` callbacks are synchronous by contract.
+ */
+import { type McpToolResponse } from '../types/mcp.js';
+/**
+ * Read a YAML file from disk synchronously.
+ * @param filePath - Absolute or relative path to a .yaml/.yml file.
+ * @returns The raw file contents as a UTF-8 string.
+ * @throws If the path escapes WORKSPACE_DIR, has an invalid extension, does not exist, or is unreadable.
+ */
+export declare function readYamlFile(filePath: string): string;
+/**
+ * Resolve yaml/file_path mutual exclusion for tool preProcess hooks.
+ * @param input - Parsed tool input containing optional `yaml` and/or `file_path`.
+ * @param options - `{ required: true }` if at least one must be provided (create/validate), `false` for update.
+ * @returns The input with `yaml` populated from file (if file_path given), or an McpToolResponse error.
+ */
+export declare function resolveYamlInput<T extends {
+    yaml?: string;
+    file_path?: string;
+}>(input: T, options: {
+    required: boolean;
+}): T | McpToolResponse;
+//# sourceMappingURL=read-yaml-file.d.ts.map

package/dist/utils/read-yaml-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-yaml-file.d.ts","sourceRoot":"","sources":["../../src/utils/read-yaml-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAe5E;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsDrD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9E,KAAK,EAAE,CAAC,EACR,OAAO,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,GAC7B,CAAC,GAAG,eAAe,CAWrB"}

package/dist/utils/read-yaml-file.js

@@ -0,0 +1,89 @@
+/**
+ * Read YAML file from disk (sync) and resolve yaml/file_path input.
+ *
+ * Used by tools that accept `file_path` as an alternative to inline `yaml`.
+ * Sync because `preProcess` callbacks are synchronous by contract.
+ */
+import { readFileSync, realpathSync, statSync } from 'node:fs';
+import { resolve, extname } from 'node:path';
+import { createErrorResponse } from '../types/mcp.js';
+const ALLOWED_EXTENSIONS = new Set(['.yaml', '.yml']);
+const MAX_FILE_SIZE_BYTES = 5 * 1024 * 1024; // 5 MB
+/**
+ * Get the base directory for file_path containment.
+ * Resolved paths must start with this directory to prevent path traversal (CWE-22).
+ * Defaults to cwd if WORKSPACE_DIR is not set.
+ * Evaluated per-call so env var changes (e.g., in tests) take effect.
+ */
+function getWorkspaceDir() {
+    return resolve(process.env['WORKSPACE_DIR'] ?? process.cwd());
+}
+/**
+ * Read a YAML file from disk synchronously.
+ * @param filePath - Absolute or relative path to a .yaml/.yml file.
+ * @returns The raw file contents as a UTF-8 string.
+ * @throws If the path escapes WORKSPACE_DIR, has an invalid extension, does not exist, or is unreadable.
+ */
+export function readYamlFile(filePath) {
+    const resolved = resolve(filePath);
+    const workspaceDir = realpathSync(getWorkspaceDir());
+    // First check: catch obvious traversal before touching the filesystem
+    if (!resolved.startsWith(workspaceDir + '/') && resolved !== workspaceDir) {
+        throw new Error(`file_path must resolve within ${workspaceDir} — got ${resolved}`);
+    }
+    // Second check: dereference symlinks to prevent symlink traversal (CWE-59)
+    let real;
+    try {
+        real = realpathSync(resolved);
+    }
+    catch {
+        // File doesn't exist — let readFileSync below produce the ENOENT error
+        real = resolved;
+    }
+    if (!real.startsWith(workspaceDir + '/') && real !== workspaceDir) {
+        throw new Error(`file_path resolves outside workspace via symlink — got ${real}`);
+    }
+    const ext = extname(resolved).toLowerCase();
+    if (!ALLOWED_EXTENSIONS.has(ext)) {
+        throw new Error(`Invalid file extension "${ext}". Only .yaml and .yml files are accepted.`);
+    }
+    const stat = statSync(resolved, { throwIfNoEntry: false });
+    if (stat && stat.size > MAX_FILE_SIZE_BYTES) {
+        throw new Error(`File too large: ${resolved} (${String(stat.size)} bytes, max ${String(MAX_FILE_SIZE_BYTES)})`);
+    }
+    try {
+        return readFileSync(resolved, 'utf-8');
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error) {
+            const fsError = error;
+            if (fsError.code === 'ENOENT') {
+                throw new Error(`File not found: ${resolved}`);
+            }
+            if (fsError.code === 'EACCES') {
+                throw new Error(`Permission denied: ${resolved}`);
+            }
+            throw new Error(`Failed to read file: ${resolved} (${fsError.code ?? 'unknown'})`);
+        }
+        throw new Error(`Failed to read file: ${resolved}`);
+    }
+}
+/**
+ * Resolve yaml/file_path mutual exclusion for tool preProcess hooks.
+ * @param input - Parsed tool input containing optional `yaml` and/or `file_path`.
+ * @param options - `{ required: true }` if at least one must be provided (create/validate), `false` for update.
+ * @returns The input with `yaml` populated from file (if file_path given), or an McpToolResponse error.
+ */
+export function resolveYamlInput(input, options) {
+    if (options.required && input.yaml === undefined && input.file_path === undefined) {
+        return createErrorResponse('Provide either yaml or file_path');
+    }
+    if (input.yaml !== undefined && input.file_path !== undefined) {
+        return createErrorResponse('Provide only one of yaml or file_path, not both');
+    }
+    if (input.file_path !== undefined) {
+        return { ...input, yaml: readYamlFile(input.file_path) };
+    }
+    return input;
+}
+//# sourceMappingURL=read-yaml-file.js.map

package/dist/utils/read-yaml-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-yaml-file.js","sourceRoot":"","sources":["../../src/utils/read-yaml-file.ts"],"names":[],"mappings":"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"}

package/dist/utils/session-state.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Session-level state for the MCP server.
+ *
+ * Safe to use in-memory because StdioTransport creates a 1:1 relationship
+ * between client and server process — there is exactly one session per process.
+ * No multi-tenant concerns.
+ */
+import type { z } from 'zod';
+import type { DefinitionTypeSchema } from '../types/index.js';
+type DefinitionType = z.infer<typeof DefinitionTypeSchema>;
+/** Get the session-level default definition type. */
+export declare function getDefaultType(): DefinitionType | undefined;
+/** Set or clear the session-level default definition type. Pass undefined to clear. */
+export declare function setDefaultType(type: DefinitionType | undefined): void;
+/** Get the full session state (for returning to callers). */
+export declare function getSessionState(): {
+    defaultType: DefinitionType | undefined;
+};
+export {};
+//# sourceMappingURL=session-state.d.ts.map

package/dist/utils/session-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../../src/utils/session-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAI3D,qDAAqD;AACrD,wBAAgB,cAAc,IAAI,cAAc,GAAG,SAAS,CAE3D;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,CAErE;AAED,6DAA6D;AAC7D,wBAAgB,eAAe,IAAI;IAAE,WAAW,EAAE,cAAc,GAAG,SAAS,CAAA;CAAE,CAE7E"}

package/dist/utils/session-state.js

@@ -0,0 +1,21 @@
+/**
+ * Session-level state for the MCP server.
+ *
+ * Safe to use in-memory because StdioTransport creates a 1:1 relationship
+ * between client and server process — there is exactly one session per process.
+ * No multi-tenant concerns.
+ */
+let defaultType;
+/** Get the session-level default definition type. */
+export function getDefaultType() {
+    return defaultType;
+}
+/** Set or clear the session-level default definition type. Pass undefined to clear. */
+export function setDefaultType(type) {
+    defaultType = type;
+}
+/** Get the full session state (for returning to callers). */
+export function getSessionState() {
+    return { defaultType };
+}
+//# sourceMappingURL=session-state.js.map

package/dist/utils/session-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.js","sourceRoot":"","sources":["../../src/utils/session-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,IAAI,WAAuC,CAAC;AAE5C,qDAAqD;AACrD,MAAM,UAAU,cAAc;IAC5B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,cAAc,CAAC,IAAgC;IAC7D,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,eAAe;IAC7B,OAAO,EAAE,WAAW,EAAE,CAAC;AACzB,CAAC"}

package/dist/utils/tool-handler.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Tool handler factory
+ *
+ * Creates standardized MCP tool handlers with consistent error handling.
+ * Eliminates boilerplate across tool implementations.
+ */
+import { z } from 'zod';
+import { type McpToolResponse } from '../types/index.js';
+/**
+ * Normalized input after snake_case→camelCase key transformation.
+ *
+ * Uses `any` deliberately — Zod validates structure before normalizeKeys() runs,
+ * but TypeScript cannot statically track the snake_case→camelCase key renaming.
+ * Callers access fields positionally (e.g. `n.type`, `n.name`) which are
+ * guaranteed valid by the preceding Zod parse. `Record<string, unknown>` was
+ * evaluated but rejected: it requires explicit casts in all 31 tool callbacks
+ * for SDK methods expecting specific types (string, number, enum literals).
+ *
+ * @see normalizeKeys in normalize-keys.ts
+ */
+type NormalizedInput = any;
+/**
+ * Creates a standardized tool handler with Zod validation, key normalization,
+ * and SDK error mapping.
+ *
+ * All handlers follow the same flow:
+ * 1. Parse input with Zod schema (validates snake_case MCP input)
+ * 2. Normalize keys from snake_case -> camelCase for SDK
+ * 3. Call SDK method with normalized input
+ * 4. Return success response or mapped error
+ *
+ * Timeout enforcement is handled by the RegistryClient SDK (configured via
+ * ULUOPS_REGISTRY_TIMEOUT env var, default 30s). No additional timeout is
+ * needed at this layer.
+ */
+export declare function createToolHandler<TInput extends Record<string, unknown>>(schema: z.ZodSchema<TInput>, sdkCall: (normalized: NormalizedInput) => Promise<unknown>, options?: {
+    /** Transform parsed input before normalization. Must be synchronous (MCP SDK constraint). Return McpToolResponse to short-circuit. */
+    preProcess?: (input: TInput) => TInput | McpToolResponse;
+    /** Transform SDK result before wrapping in success response. Use to trim large fields. */
+    postProcess?: (result: unknown) => unknown;
+}): (args: unknown) => Promise<McpToolResponse>;
+/**
+ * Inject session-level default type into args if not explicitly provided.
+ * Safe for blanket injection — Zod strips unknown keys from tools that don't declare `type`.
+ */
+export declare function injectSessionType(args: unknown): unknown;
+/**
+ * Extract the `fields` meta-parameter from raw args before Zod validation.
+ * Removes it from the args so Zod doesn't reject it as an unknown key.
+ */
+export declare function extractFieldsParam(args: unknown): {
+    cleanArgs: unknown;
+    fields: string[] | undefined;
+};
+/**
+ * Filter response fields to only include requested properties.
+ * Preserves pagination metadata. For array properties, picks fields from each item.
+ */
+export declare function filterResponseFields(data: unknown, fields: string[]): unknown;
+export {};
+//# sourceMappingURL=tool-handler.d.ts.map

package/dist/utils/tool-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-handler.d.ts","sourceRoot":"","sources":["../../src/utils/tool-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AA+ChF;;;;;;;;;;;GAWG;AACH,KAAK,eAAe,GAAG,GAAG,CAAC;AAE3B;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,EAC3B,OAAO,EAAE,CAIP,UAAU,EAAE,eAAe,KACxB,OAAO,CAAC,OAAO,CAAC,EACrB,OAAO,CAAC,EAAE;IACR,sIAAsI;IACtI,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,eAAe,CAAC;IACzD,0FAA0F;IAC1F,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;CAC5C,GACA,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,eAAe,CAAC,CA8C7C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAWxD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG;IACjD,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAC9B,CAiBA;AAKD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CA+B7E"}