@qikdev/mcp 6.6.10 → 6.6.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,56 +1,15 @@
1
1
  #!/usr/bin/env node
2
2
  /**
3
- * Qik Platform MCP Server - Enhanced Version with Comprehensive Documentation
3
+ * Simplified Qik Platform MCP Server
4
4
  *
5
- * This MCP server provides comprehensive integration with the Qik platform,
6
- * enabling AI assistants to interact with Qik's content management system,
7
- * user management, forms, files, and more.
8
- *
9
- * Key Features:
10
- * - Glossary-driven architecture for dynamic content type discovery
11
- * - Smart validation based on content type definitions
12
- * - Context-aware error handling and suggestions
13
- * - Dynamic tool schema generation
14
- * - Comprehensive API coverage
15
- * - Intelligent request building and field validation
16
- * - Advanced disambiguation logic for definitions vs instances
17
- * - Workflow system documentation and automation
18
- * - Comprehensive scope and permission management
19
- *
20
- * IMPORTANT QIK CONCEPTS:
21
- *
22
- * 1. DEFINITIONS vs INSTANCES:
23
- * - Definitions: Templates that define structure (e.g., "workflow definition", "content type definition")
24
- * - Instances: Actual content items created from definitions (e.g., "workflow card", "article instance")
25
- * - When user says "create a workflow" they usually mean create a workflow DEFINITION
26
- * - When user says "add Jim to workflow X" they mean create a workflow CARD instance
27
- *
28
- * 2. WORKFLOW SYSTEM:
29
- * - Workflow Definitions: Define the structure with columns, steps, automation
30
- * - Workflow Cards: Individual items that move through the workflow
31
- * - Columns: Represent stages in the workflow (e.g., "To Do", "In Progress", "Done")
32
- * - Steps: Specific positions within columns where cards can be placed
33
- * - Automation: Entry/exit/success/fail functions that run when cards move
34
- *
35
- * 3. SCOPE SYSTEM:
36
- * - Hierarchical permission structure (like folders)
37
- * - Every content item must belong to at least one scope
38
- * - Users need appropriate permissions within scopes to perform actions
39
- * - Scopes can inherit permissions from parent scopes
40
- *
41
- * 4. CONTENT TYPE SYSTEM:
42
- * - Base types: Core Qik types (article, profile, event, etc.)
43
- * - Extended types: Custom types that extend base types with additional fields
44
- * - Fields vs DefinedFields: Fields go at root level, definedFields go in data object
5
+ * A simple translation layer between AI models and the Qik API.
6
+ * Focuses on core functionality with interactive error handling.
45
7
  */
46
8
  export declare class QikMCPServer {
47
9
  private server;
48
10
  private axiosInstance;
49
- private glossary;
50
- private aiGlossary;
51
11
  private userSession;
52
- private lastGlossaryUpdate;
53
- private readonly GLOSSARY_CACHE_TTL;
12
+ private glossary;
54
13
  private serverName;
55
14
  constructor();
56
15
  private log;
@@ -59,118 +18,19 @@ export declare class QikMCPServer {
59
18
  private loadUserSession;
60
19
  private loadGlossary;
61
20
  private formatError;
62
- private getContentTypeInfo;
63
- private validateContentType;
64
- private isFieldRequired;
65
- private isFieldArray;
66
- private getMinimumArrayLength;
67
- /**
68
- * Validates widget-specific field values
69
- */
70
- private validateWidgetValue;
71
- /**
72
- * Validates dateobject widget values
73
- */
74
- private validateDateObjectWidget;
75
- private generateFieldPath;
76
- private processGroupFields;
77
- private analyzeContentTypeFields;
78
- private validateFieldData;
79
- private generateFieldSchema;
80
- private generateFieldsSchema;
81
- private mapFieldTypeToJsonSchema;
82
- /**
83
- * Generates completely dynamic properties based on the loaded glossary
84
- * This creates schema properties for ALL fields from ALL content types
85
- */
86
- private generateDynamicContentProperties;
87
- private findContentTypesByDescription;
88
- private findContentTypeByDescription;
89
- private getAvailableScopes;
90
- private extractScopesWithPermissions;
91
- private validateFilter;
92
- private createBirthdayFilter;
93
- private createDateRangeFilter;
94
- private createGenderFilter;
95
- private createAgeRangeFilter;
96
- private createThisMonthBirthdayFilter;
97
- private createRecentContentFilter;
98
- private createScopeFilter;
99
- /**
100
- * Filters out readOnly fields from payload for create/update operations
101
- */
102
- private filterReadOnlyFields;
103
- private generateEnhancedFilterSchema;
104
- /**
105
- * Enhanced intelligent content creation with advanced disambiguation logic
106
- *
107
- * This method provides sophisticated analysis of user intent to distinguish between:
108
- * - Creating workflow DEFINITIONS vs workflow CARD instances
109
- * - Creating content type DEFINITIONS vs content INSTANCES
110
- * - Understanding context clues like "add person to workflow" vs "create new workflow"
111
- */
112
- private intelligentContentCreation;
113
- /**
114
- * Analyzes user intent to distinguish between different types of content creation
115
- */
116
- private analyzeUserIntent;
117
- /**
118
- * Handles workflow-specific disambiguation with comprehensive guidance
119
- */
120
- private handleWorkflowDisambiguation;
121
- /**
122
- * Handles cases where no content types match the description
123
- */
124
- private handleNoContentTypeMatches;
125
- /**
126
- * Categorizes content types for better organization in help text
127
- */
128
- private categorizeContentTypes;
129
- /**
130
- * Handles cases where multiple content types match
131
- */
132
- private handleMultipleContentTypeMatches;
133
- /**
134
- * Handles single content type match with comprehensive guidance
135
- */
136
- private handleSingleContentTypeMatch;
137
- /**
138
- * Analyzes content type structure for comprehensive information
139
- */
140
- private analyzeContentTypeStructure;
141
- /**
142
- * Handles content creation when data is provided
143
- */
144
- private handleContentCreationWithData;
145
- /**
146
- * Generates comprehensive creation guidance
147
- */
148
- private generateCreationGuidance;
149
- private generateToolDescription;
21
+ private promptUserForScopes;
22
+ private extractAvailableScopes;
23
+ private handleApiError;
150
24
  private setupToolHandlers;
151
25
  private getUserSession;
152
26
  private getGlossary;
153
27
  private getContentDefinition;
28
+ private getScopes;
154
29
  private getContent;
155
30
  private listContent;
156
31
  private createContent;
157
32
  private updateContent;
158
33
  private deleteContent;
159
- private listProfiles;
160
- private createProfile;
161
- private getProfileTimeline;
162
- private getProfileInfo;
163
- private getForm;
164
- private submitForm;
165
- private uploadFile;
166
- private searchContent;
167
- private getScopes;
168
- private getSmartlist;
169
- private getDocumentation;
170
- private searchDocumentation;
171
- private getTroubleshooting;
172
- private getExamples;
173
- private validateFieldPlacement;
174
34
  run(): Promise<void>;
175
35
  }
176
36
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAiMH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,UAAU,CAA2C;IAC7D,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAiB;IACpD,OAAO,CAAC,UAAU,CAAiB;;IAwCnC,OAAO,CAAC,GAAG;YAQG,gBAAgB;YAchB,cAAc;YAgBd,eAAe;YAUf,YAAY;IAmC1B,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,qBAAqB;IAM7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAsD3B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAgEhC,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,wBAAwB;IAgChC,OAAO,CAAC,iBAAiB;IAmDzB,OAAO,CAAC,mBAAmB;IAwB3B,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,wBAAwB;IAsBhC;;;OAGG;IACH,OAAO,CAAC,gCAAgC;IAsFxC,OAAO,CAAC,6BAA6B;IAkFrC,OAAO,CAAC,4BAA4B;YAKtB,kBAAkB;IAUhC,OAAO,CAAC,4BAA4B;IAqCpC,OAAO,CAAC,cAAc;IAoEtB,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,qBAAqB;IAY7B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,6BAA6B;IAcrC,OAAO,CAAC,yBAAyB;IAYjC,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgD5B,OAAO,CAAC,4BAA4B;IAqHpC;;;;;;;OAOG;YACW,0BAA0B;IAyBxC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyDzB;;OAEG;YACW,4BAA4B;IA2J1C;;OAEG;YACW,0BAA0B;IAgDxC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4C9B;;OAEG;YACW,gCAAgC;IAoD9C;;OAEG;YACW,4BAA4B;IAuD1C;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAoCnC;;OAEG;YACW,6BAA6B;IAuC3C;;OAEG;YACW,wBAAwB;IAqCtC,OAAO,CAAC,uBAAuB;IAK/B,OAAO,CAAC,iBAAiB;YAiqBX,cAAc;YAad,WAAW;YAkGX,oBAAoB;YA+BpB,UAAU;YA6BV,WAAW;YAsCX,aAAa;YA8Db,aAAa;YAsCb,aAAa;YAoBb,YAAY;YAyBZ,aAAa;YA6Bb,kBAAkB;YAyBlB,cAAc;YAkKd,OAAO;YAoBP,UAAU;YAoBV,UAAU;YAsCV,aAAa;YAiCb,SAAS;YAoBT,YAAY;YAqBZ,gBAAgB;YAwDhB,mBAAmB;YAqEnB,kBAAkB;YAiGlB,WAAW;YAgHX,sBAAsB;IAwE9B,GAAG;CAKV"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAiDH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,UAAU,CAAiB;;IAwCnC,OAAO,CAAC,GAAG;YAMG,gBAAgB;YAWhB,cAAc;YAYd,eAAe;YAUf,YAAY;IAe1B,OAAO,CAAC,WAAW;YAaL,mBAAmB;IAqCjC,OAAO,CAAC,sBAAsB;YAkChB,cAAc;IA6E5B,OAAO,CAAC,iBAAiB;YAsMX,cAAc;YAad,WAAW;YAwBX,oBAAoB;YA4BpB,SAAS;YAiBT,UAAU;YAyBV,WAAW;YAiCX,aAAa;YA+Bb,aAAa;YAoBb,aAAa;IAiBrB,GAAG;CAKV"}