@qikdev/mcp 6.6.9 → 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.
- package/build/src/index.d.ts +8 -143
- package/build/src/index.d.ts.map +1 -1
- package/build/src/index.js +186 -2693
- package/build/src/index.js.map +1 -1
- package/build/src/simple-index.d.ts +36 -0
- package/build/src/simple-index.d.ts.map +1 -0
- package/build/src/simple-index.js +644 -0
- package/build/src/simple-index.js.map +1 -0
- package/package.json +1 -1
package/build/src/index.d.ts
CHANGED
|
@@ -1,55 +1,15 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
/**
|
|
3
|
-
* Qik Platform MCP Server
|
|
3
|
+
* Simplified Qik Platform MCP Server
|
|
4
4
|
*
|
|
5
|
-
*
|
|
6
|
-
*
|
|
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
11
|
private userSession;
|
|
51
|
-
private
|
|
52
|
-
private readonly GLOSSARY_CACHE_TTL;
|
|
12
|
+
private glossary;
|
|
53
13
|
private serverName;
|
|
54
14
|
constructor();
|
|
55
15
|
private log;
|
|
@@ -58,114 +18,19 @@ export declare class QikMCPServer {
|
|
|
58
18
|
private loadUserSession;
|
|
59
19
|
private loadGlossary;
|
|
60
20
|
private formatError;
|
|
61
|
-
private
|
|
62
|
-
private
|
|
63
|
-
private
|
|
64
|
-
private isFieldArray;
|
|
65
|
-
private getMinimumArrayLength;
|
|
66
|
-
/**
|
|
67
|
-
* Validates widget-specific field values
|
|
68
|
-
*/
|
|
69
|
-
private validateWidgetValue;
|
|
70
|
-
/**
|
|
71
|
-
* Validates dateobject widget values
|
|
72
|
-
*/
|
|
73
|
-
private validateDateObjectWidget;
|
|
74
|
-
private generateFieldPath;
|
|
75
|
-
private processGroupFields;
|
|
76
|
-
private analyzeContentTypeFields;
|
|
77
|
-
private validateFieldData;
|
|
78
|
-
private generateFieldSchema;
|
|
79
|
-
private generateFieldsSchema;
|
|
80
|
-
private mapFieldTypeToJsonSchema;
|
|
81
|
-
/**
|
|
82
|
-
* Generates completely dynamic properties based on the loaded glossary
|
|
83
|
-
* This creates schema properties for ALL fields from ALL content types
|
|
84
|
-
*/
|
|
85
|
-
private generateDynamicContentProperties;
|
|
86
|
-
private findContentTypesByDescription;
|
|
87
|
-
private findContentTypeByDescription;
|
|
88
|
-
private getAvailableScopes;
|
|
89
|
-
private extractScopesWithPermissions;
|
|
90
|
-
private validateFilter;
|
|
91
|
-
private createBirthdayFilter;
|
|
92
|
-
private createDateRangeFilter;
|
|
93
|
-
private createGenderFilter;
|
|
94
|
-
private createAgeRangeFilter;
|
|
95
|
-
private createThisMonthBirthdayFilter;
|
|
96
|
-
private createRecentContentFilter;
|
|
97
|
-
private createScopeFilter;
|
|
98
|
-
private generateEnhancedFilterSchema;
|
|
99
|
-
/**
|
|
100
|
-
* Enhanced intelligent content creation with advanced disambiguation logic
|
|
101
|
-
*
|
|
102
|
-
* This method provides sophisticated analysis of user intent to distinguish between:
|
|
103
|
-
* - Creating workflow DEFINITIONS vs workflow CARD instances
|
|
104
|
-
* - Creating content type DEFINITIONS vs content INSTANCES
|
|
105
|
-
* - Understanding context clues like "add person to workflow" vs "create new workflow"
|
|
106
|
-
*/
|
|
107
|
-
private intelligentContentCreation;
|
|
108
|
-
/**
|
|
109
|
-
* Analyzes user intent to distinguish between different types of content creation
|
|
110
|
-
*/
|
|
111
|
-
private analyzeUserIntent;
|
|
112
|
-
/**
|
|
113
|
-
* Handles workflow-specific disambiguation with comprehensive guidance
|
|
114
|
-
*/
|
|
115
|
-
private handleWorkflowDisambiguation;
|
|
116
|
-
/**
|
|
117
|
-
* Handles cases where no content types match the description
|
|
118
|
-
*/
|
|
119
|
-
private handleNoContentTypeMatches;
|
|
120
|
-
/**
|
|
121
|
-
* Categorizes content types for better organization in help text
|
|
122
|
-
*/
|
|
123
|
-
private categorizeContentTypes;
|
|
124
|
-
/**
|
|
125
|
-
* Handles cases where multiple content types match
|
|
126
|
-
*/
|
|
127
|
-
private handleMultipleContentTypeMatches;
|
|
128
|
-
/**
|
|
129
|
-
* Handles single content type match with comprehensive guidance
|
|
130
|
-
*/
|
|
131
|
-
private handleSingleContentTypeMatch;
|
|
132
|
-
/**
|
|
133
|
-
* Analyzes content type structure for comprehensive information
|
|
134
|
-
*/
|
|
135
|
-
private analyzeContentTypeStructure;
|
|
136
|
-
/**
|
|
137
|
-
* Handles content creation when data is provided
|
|
138
|
-
*/
|
|
139
|
-
private handleContentCreationWithData;
|
|
140
|
-
/**
|
|
141
|
-
* Generates comprehensive creation guidance
|
|
142
|
-
*/
|
|
143
|
-
private generateCreationGuidance;
|
|
144
|
-
private generateToolDescription;
|
|
21
|
+
private promptUserForScopes;
|
|
22
|
+
private extractAvailableScopes;
|
|
23
|
+
private handleApiError;
|
|
145
24
|
private setupToolHandlers;
|
|
146
25
|
private getUserSession;
|
|
147
26
|
private getGlossary;
|
|
148
27
|
private getContentDefinition;
|
|
28
|
+
private getScopes;
|
|
149
29
|
private getContent;
|
|
150
30
|
private listContent;
|
|
151
31
|
private createContent;
|
|
152
32
|
private updateContent;
|
|
153
33
|
private deleteContent;
|
|
154
|
-
private listProfiles;
|
|
155
|
-
private createProfile;
|
|
156
|
-
private getProfileTimeline;
|
|
157
|
-
private getProfileInfo;
|
|
158
|
-
private getForm;
|
|
159
|
-
private submitForm;
|
|
160
|
-
private uploadFile;
|
|
161
|
-
private searchContent;
|
|
162
|
-
private getScopes;
|
|
163
|
-
private getSmartlist;
|
|
164
|
-
private getDocumentation;
|
|
165
|
-
private searchDocumentation;
|
|
166
|
-
private getTroubleshooting;
|
|
167
|
-
private getExamples;
|
|
168
|
-
private validateFieldPlacement;
|
|
169
34
|
run(): Promise<void>;
|
|
170
35
|
}
|
|
171
36
|
//# sourceMappingURL=index.d.ts.map
|
package/build/src/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA
|
|
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"}
|