@qikdev/mcp 6.6.3 → 6.6.5

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.
Files changed (5) hide show
  1. package/build/src/index.d.ts +77 -1
  2. package/build/src/index.d.ts.map +1 -1
  3. package/build/src/index.js +682 -140
  4. package/build/src/index.js.map +1 -1
  5. package/package.json +1 -1
package/build/src/index.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  /**
3
- * Qik Platform MCP Server - Enhanced Version
3
+ * Qik Platform MCP Server - Enhanced Version with Comprehensive Documentation
4
4
  *
5
5
  * This MCP server provides comprehensive integration with the Qik platform,
6
6
  * enabling AI assistants to interact with Qik's content management system,
@@ -13,6 +13,35 @@
13
13
  * - Dynamic tool schema generation
14
14
  * - Comprehensive API coverage
15
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
16
45
  */
17
46
  export declare class QikMCPServer {
18
47
  private server;
@@ -21,9 +50,11 @@ export declare class QikMCPServer {
21
50
  private userSession;
22
51
  private lastGlossaryUpdate;
23
52
  private readonly GLOSSARY_CACHE_TTL;
53
+ private serverName;
24
54
  constructor();
25
55
  private log;
26
56
  private initializeServer;
57
+ private loadServerName;
27
58
  private loadUserSession;
28
59
  private loadGlossary;
29
60
  private formatError;
@@ -53,7 +84,52 @@ export declare class QikMCPServer {
53
84
  private createRecentContentFilter;
54
85
  private createScopeFilter;
55
86
  private generateEnhancedFilterSchema;
87
+ /**
88
+ * Enhanced intelligent content creation with advanced disambiguation logic
89
+ *
90
+ * This method provides sophisticated analysis of user intent to distinguish between:
91
+ * - Creating workflow DEFINITIONS vs workflow CARD instances
92
+ * - Creating content type DEFINITIONS vs content INSTANCES
93
+ * - Understanding context clues like "add person to workflow" vs "create new workflow"
94
+ */
56
95
  private intelligentContentCreation;
96
+ /**
97
+ * Analyzes user intent to distinguish between different types of content creation
98
+ */
99
+ private analyzeUserIntent;
100
+ /**
101
+ * Handles workflow-specific disambiguation with comprehensive guidance
102
+ */
103
+ private handleWorkflowDisambiguation;
104
+ /**
105
+ * Handles cases where no content types match the description
106
+ */
107
+ private handleNoContentTypeMatches;
108
+ /**
109
+ * Categorizes content types for better organization in help text
110
+ */
111
+ private categorizeContentTypes;
112
+ /**
113
+ * Handles cases where multiple content types match
114
+ */
115
+ private handleMultipleContentTypeMatches;
116
+ /**
117
+ * Handles single content type match with comprehensive guidance
118
+ */
119
+ private handleSingleContentTypeMatch;
120
+ /**
121
+ * Analyzes content type structure for comprehensive information
122
+ */
123
+ private analyzeContentTypeStructure;
124
+ /**
125
+ * Handles content creation when data is provided
126
+ */
127
+ private handleContentCreationWithData;
128
+ /**
129
+ * Generates comprehensive creation guidance
130
+ */
131
+ private generateCreationGuidance;
132
+ private generateToolDescription;
57
133
  private setupToolHandlers;
58
134
  private getUserSession;
59
135
  private getGlossary;
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;;;;;;;;;;;;;;GAcG;AAuKH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAiB;;IAwCpD,OAAO,CAAC,GAAG;YAQG,gBAAgB;YAYhB,eAAe;YAUf,YAAY;IAuC1B,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,qBAAqB;IAI7B,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,OAAO,CAAC,gCAAgC;IAkCxC,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,OAAO,CAAC,4BAA4B;YAqHtB,0BAA0B;IA8KxC,OAAO,CAAC,iBAAiB;YAmgBX,cAAc;YAad,WAAW;YAkGX,oBAAoB;YA+BpB,UAAU;YA6BV,WAAW;YAsCX,aAAa;YAmHb,aAAa;YAqBb,aAAa;YAoBb,YAAY;YAyBZ,aAAa;YA6Bb,OAAO;YAoBP,UAAU;YAoBV,UAAU;YAsCV,aAAa;YAiCb,SAAS;YAoBT,YAAY;IAoBpB,GAAG;CAKV"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAwKH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAyC;IACzD,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;IAuC1B,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,qBAAqB;IAI7B,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,OAAO,CAAC,gCAAgC;IAkCxC,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,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;YAmnBX,cAAc;YAad,WAAW;YAkGX,oBAAoB;YA+BpB,UAAU;YA6BV,WAAW;YAsCX,aAAa;YAmHb,aAAa;YAqBb,aAAa;YAoBb,YAAY;YAyBZ,aAAa;YA6Bb,OAAO;YAoBP,UAAU;YAoBV,UAAU;YAsCV,aAAa;YAiCb,SAAS;YAoBT,YAAY;IAoBpB,GAAG;CAKV"}