@imagekit/api-mcp 7.2.2 → 7.4.0

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 (144) hide show
  1. package/auth.d.mts +6 -0
  2. package/auth.d.mts.map +1 -0
  3. package/auth.d.ts +6 -0
  4. package/auth.d.ts.map +1 -0
  5. package/{headers.mjs → auth.js} +21 -2
  6. package/auth.js.map +1 -0
  7. package/{headers.js → auth.mjs} +16 -6
  8. package/auth.mjs.map +1 -0
  9. package/code-tool-paths.cjs +8 -0
  10. package/code-tool-paths.cjs.map +1 -0
  11. package/code-tool-paths.d.cts +2 -0
  12. package/code-tool-paths.d.cts.map +1 -0
  13. package/code-tool-types.d.mts.map +1 -1
  14. package/code-tool-types.d.ts.map +1 -1
  15. package/code-tool-worker.d.mts +5 -0
  16. package/code-tool-worker.d.mts.map +1 -0
  17. package/code-tool-worker.d.ts +5 -0
  18. package/code-tool-worker.d.ts.map +1 -0
  19. package/code-tool-worker.js +314 -0
  20. package/code-tool-worker.js.map +1 -0
  21. package/code-tool-worker.mjs +276 -0
  22. package/code-tool-worker.mjs.map +1 -0
  23. package/code-tool.d.mts +11 -2
  24. package/code-tool.d.mts.map +1 -1
  25. package/code-tool.d.ts +11 -2
  26. package/code-tool.d.ts.map +1 -1
  27. package/code-tool.js +285 -42
  28. package/code-tool.js.map +1 -1
  29. package/code-tool.mjs +253 -43
  30. package/code-tool.mjs.map +1 -1
  31. package/docs-search-tool.d.mts +11 -3
  32. package/docs-search-tool.d.mts.map +1 -1
  33. package/docs-search-tool.d.ts +11 -3
  34. package/docs-search-tool.d.ts.map +1 -1
  35. package/docs-search-tool.js +58 -5
  36. package/docs-search-tool.js.map +1 -1
  37. package/docs-search-tool.mjs +57 -5
  38. package/docs-search-tool.mjs.map +1 -1
  39. package/http.d.mts +6 -3
  40. package/http.d.mts.map +1 -1
  41. package/http.d.ts +6 -3
  42. package/http.d.ts.map +1 -1
  43. package/http.js +130 -28
  44. package/http.js.map +1 -1
  45. package/http.mjs +130 -28
  46. package/http.mjs.map +1 -1
  47. package/index.js +17 -12
  48. package/index.js.map +1 -1
  49. package/index.mjs +17 -12
  50. package/index.mjs.map +1 -1
  51. package/instructions.d.mts +5 -0
  52. package/instructions.d.mts.map +1 -0
  53. package/instructions.d.ts +5 -0
  54. package/instructions.d.ts.map +1 -0
  55. package/instructions.js +61 -0
  56. package/instructions.js.map +1 -0
  57. package/instructions.mjs +55 -0
  58. package/instructions.mjs.map +1 -0
  59. package/local-docs-search.d.mts +28 -0
  60. package/local-docs-search.d.mts.map +1 -0
  61. package/local-docs-search.d.ts +28 -0
  62. package/local-docs-search.d.ts.map +1 -0
  63. package/local-docs-search.js +2807 -0
  64. package/local-docs-search.js.map +1 -0
  65. package/local-docs-search.mjs +2767 -0
  66. package/local-docs-search.mjs.map +1 -0
  67. package/logger.d.mts +7 -0
  68. package/logger.d.mts.map +1 -0
  69. package/logger.d.ts +7 -0
  70. package/logger.d.ts.map +1 -0
  71. package/logger.js +29 -0
  72. package/logger.js.map +1 -0
  73. package/logger.mjs +22 -0
  74. package/logger.mjs.map +1 -0
  75. package/methods.d.mts +10 -0
  76. package/methods.d.mts.map +1 -0
  77. package/methods.d.ts +10 -0
  78. package/methods.d.ts.map +1 -0
  79. package/methods.js +349 -0
  80. package/methods.js.map +1 -0
  81. package/methods.mjs +345 -0
  82. package/methods.mjs.map +1 -0
  83. package/options.d.mts +12 -0
  84. package/options.d.mts.map +1 -1
  85. package/options.d.ts +12 -0
  86. package/options.d.ts.map +1 -1
  87. package/options.js +81 -12
  88. package/options.js.map +1 -1
  89. package/options.mjs +81 -12
  90. package/options.mjs.map +1 -1
  91. package/package.json +89 -15
  92. package/server.d.mts +18 -11
  93. package/server.d.mts.map +1 -1
  94. package/server.d.ts +18 -11
  95. package/server.d.ts.map +1 -1
  96. package/server.js +89 -49
  97. package/server.js.map +1 -1
  98. package/server.mjs +88 -45
  99. package/server.mjs.map +1 -1
  100. package/src/{headers.ts → auth.ts} +18 -1
  101. package/src/code-tool-paths.cts +5 -0
  102. package/src/code-tool-types.ts +1 -0
  103. package/src/code-tool-worker.ts +327 -0
  104. package/src/code-tool.ts +339 -55
  105. package/src/docs-search-tool.ts +86 -7
  106. package/src/http.ts +154 -33
  107. package/src/index.ts +19 -13
  108. package/src/instructions.ts +83 -0
  109. package/src/local-docs-search.ts +3380 -0
  110. package/src/logger.ts +28 -0
  111. package/src/methods.ts +370 -0
  112. package/src/options.ts +105 -12
  113. package/src/server.ts +111 -57
  114. package/src/stdio.ts +9 -4
  115. package/src/types.ts +15 -4
  116. package/src/util.ts +25 -0
  117. package/stdio.d.mts +2 -1
  118. package/stdio.d.mts.map +1 -1
  119. package/stdio.d.ts +2 -1
  120. package/stdio.d.ts.map +1 -1
  121. package/stdio.js +8 -4
  122. package/stdio.js.map +1 -1
  123. package/stdio.mjs +8 -4
  124. package/stdio.mjs.map +1 -1
  125. package/types.d.mts +14 -1
  126. package/types.d.mts.map +1 -1
  127. package/types.d.ts +14 -1
  128. package/types.d.ts.map +1 -1
  129. package/types.js.map +1 -1
  130. package/types.mjs.map +1 -1
  131. package/util.d.mts +4 -0
  132. package/util.d.mts.map +1 -0
  133. package/util.d.ts +4 -0
  134. package/util.d.ts.map +1 -0
  135. package/util.js +30 -0
  136. package/util.js.map +1 -0
  137. package/util.mjs +24 -0
  138. package/util.mjs.map +1 -0
  139. package/headers.d.mts +0 -4
  140. package/headers.d.mts.map +0 -1
  141. package/headers.d.ts +0 -4
  142. package/headers.d.ts.map +0 -1
  143. package/headers.js.map +0 -1
  144. package/headers.mjs.map +0 -1
package/index.mjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":";OAEO,EAAE,WAAW,EAAE;OACf,EAAc,eAAe,EAAE;OAC/B,EAAE,iBAAiB,EAAE;OACrB,EAAE,0BAA0B,EAAE;AAGrC,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IAEtC,MAAM,aAAa,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAExD,OAAO,CAAC,KAAK,CACX,4BAA4B,aAAa,CAAC,MAAM,SAAS,EACzD,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACtC,CAAC;IAEF,QAAQ,OAAO,CAAC,SAAS,EAAE,CAAC;QAC1B,KAAK,OAAO;YACV,MAAM,iBAAiB,EAAE,CAAC;YAC1B,MAAM;QACR,KAAK,MAAM;YACT,MAAM,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1E,MAAM;IACV,CAAC;AACH,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACrB,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB;IAC1B,IAAI,CAAC;QACH,OAAO,eAAe,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,OAAmB;IACnD,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"index.mjs","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":";OAEO,EAAE,WAAW,EAAE;OACf,EAAc,eAAe,EAAE;OAC/B,EAAE,iBAAiB,EAAE;OACrB,EAAE,0BAA0B,EAAE;OAE9B,EAAE,eAAe,EAAE,SAAS,EAAE;AAErC,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACtC,eAAe,CAAC;QACd,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;QACvC,MAAM,EAAE,OAAO,CAAC,SAAS,KAAK,QAAQ;KACvC,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAExD,SAAS,EAAE,CAAC,IAAI,CACd,EAAE,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAChD,4BAA4B,aAAa,CAAC,MAAM,QAAQ,CACzD,CAAC;IAEF,QAAQ,OAAO,CAAC,SAAS,EAAE,CAAC;QAC1B,KAAK,OAAO;YACV,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;YACjC,MAAM;QACR,KAAK,MAAM;YACT,MAAM,0BAA0B,CAAC;gBAC/B,UAAU,EAAE,OAAO;gBACnB,IAAI,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI;aACrC,CAAC,CAAC;YACH,MAAM;IACV,CAAC;AACH,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACrB,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB;IAC1B,IAAI,CAAC;QACH,OAAO,eAAe,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iEAAiE;QACjE,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,OAAmB;IACnD,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,SAAS,EAAE,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;YACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,uBAAuB,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
@@ -0,0 +1,5 @@
1
+ export declare function getInstructions({ stainlessApiKey, customInstructionsPath, }: {
2
+ stainlessApiKey?: string | undefined;
3
+ customInstructionsPath?: string | undefined;
4
+ }): Promise<string>;
5
+ //# sourceMappingURL=instructions.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"instructions.d.mts","sourceRoot":"","sources":["src/instructions.ts"],"names":[],"mappings":"AAeA,wBAAsB,eAAe,CAAC,EACpC,eAAe,EACf,sBAAsB,GACvB,EAAE;IACD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BlB"}
@@ -0,0 +1,5 @@
1
+ export declare function getInstructions({ stainlessApiKey, customInstructionsPath, }: {
2
+ stainlessApiKey?: string | undefined;
3
+ customInstructionsPath?: string | undefined;
4
+ }): Promise<string>;
5
+ //# sourceMappingURL=instructions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["src/instructions.ts"],"names":[],"mappings":"AAeA,wBAAsB,eAAe,CAAC,EACpC,eAAe,EACf,sBAAsB,GACvB,EAAE;IACD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BlB"}
@@ -0,0 +1,61 @@
1
+ "use strict";
2
+ // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
3
+ var __importDefault = (this && this.__importDefault) || function (mod) {
4
+ return (mod && mod.__esModule) ? mod : { "default": mod };
5
+ };
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ exports.getInstructions = getInstructions;
8
+ const promises_1 = __importDefault(require("fs/promises"));
9
+ const util_1 = require("./util.js");
10
+ const logger_1 = require("./logger.js");
11
+ const INSTRUCTIONS_CACHE_TTL_MS = 15 * 60 * 1000; // 15 minutes
12
+ const instructionsCache = new Map();
13
+ async function getInstructions({ stainlessApiKey, customInstructionsPath, }) {
14
+ const now = Date.now();
15
+ const cacheKey = customInstructionsPath ?? stainlessApiKey ?? '';
16
+ const cached = instructionsCache.get(cacheKey);
17
+ if (cached && now - cached.fetchedAt <= INSTRUCTIONS_CACHE_TTL_MS) {
18
+ return cached.fetchedInstructions;
19
+ }
20
+ // Evict stale entries so the cache doesn't grow unboundedly.
21
+ for (const [key, entry] of instructionsCache) {
22
+ if (now - entry.fetchedAt > INSTRUCTIONS_CACHE_TTL_MS) {
23
+ instructionsCache.delete(key);
24
+ }
25
+ }
26
+ let fetchedInstructions;
27
+ if (customInstructionsPath) {
28
+ fetchedInstructions = await fetchLatestInstructionsFromFile(customInstructionsPath);
29
+ }
30
+ else {
31
+ fetchedInstructions = await fetchLatestInstructionsFromApi(stainlessApiKey);
32
+ }
33
+ instructionsCache.set(cacheKey, { fetchedInstructions, fetchedAt: now });
34
+ return fetchedInstructions;
35
+ }
36
+ async function fetchLatestInstructionsFromFile(path) {
37
+ try {
38
+ return await promises_1.default.readFile(path, 'utf-8');
39
+ }
40
+ catch (error) {
41
+ (0, logger_1.getLogger)().error({ error, path }, 'Error fetching instructions from file');
42
+ throw error;
43
+ }
44
+ }
45
+ async function fetchLatestInstructionsFromApi(stainlessApiKey) {
46
+ // Setting the stainless API key is optional, but may be required
47
+ // to authenticate requests to the Stainless API.
48
+ const response = await fetch((0, util_1.readEnv)('CODE_MODE_INSTRUCTIONS_URL') ?? 'https://api.stainless.com/api/ai/instructions/imagekit', {
49
+ method: 'GET',
50
+ headers: { ...(stainlessApiKey && { Authorization: stainlessApiKey }) },
51
+ });
52
+ let instructions;
53
+ if (!response.ok) {
54
+ (0, logger_1.getLogger)().warn('Warning: failed to retrieve MCP server instructions. Proceeding with default instructions...');
55
+ instructions =
56
+ '\n This is the imagekit MCP server.\n\n Available tools:\n - search_docs: Search SDK documentation to find the right methods and parameters.\n - execute: Run TypeScript code against a pre-authenticated SDK client. Define an async run(client) function.\n\n Workflow:\n - If unsure about the API, call search_docs first.\n - Write complete solutions in a single execute call when possible. For large datasets, use API filters to narrow results or paginate within a single execute block.\n - If execute returns an error, read the error and fix your code rather than retrying the same approach.\n - Variables do not persist between execute calls. Return or log all data you need.\n - Individual HTTP requests to the API have a 30-second timeout. If a request times out, try a smaller query or add filters.\n - Code execution has a total timeout of approximately 5 minutes. If your code times out, simplify it or break it into smaller steps.\n ';
57
+ }
58
+ instructions ??= (await response.json()).instructions;
59
+ return instructions;
60
+ }
61
+ //# sourceMappingURL=instructions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"instructions.js","sourceRoot":"","sources":["src/instructions.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;AAetF,0CAgCC;AA7CD,2DAA6B;AAC7B,oCAAiC;AACjC,wCAAqC;AAErC,MAAM,yBAAyB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AAO/D,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAkC,CAAC;AAE7D,KAAK,UAAU,eAAe,CAAC,EACpC,eAAe,EACf,sBAAsB,GAIvB;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,sBAAsB,IAAI,eAAe,IAAI,EAAE,CAAC;IACjE,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAE/C,IAAI,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,yBAAyB,EAAE,CAAC;QAClE,OAAO,MAAM,CAAC,mBAAmB,CAAC;IACpC,CAAC;IAED,6DAA6D;IAC7D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAC7C,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,yBAAyB,EAAE,CAAC;YACtD,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI,mBAA2B,CAAC;IAEhC,IAAI,sBAAsB,EAAE,CAAC;QAC3B,mBAAmB,GAAG,MAAM,+BAA+B,CAAC,sBAAsB,CAAC,CAAC;IACtF,CAAC;SAAM,CAAC;QACN,mBAAmB,GAAG,MAAM,8BAA8B,CAAC,eAAe,CAAC,CAAC;IAC9E,CAAC;IAED,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,mBAAmB,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACzE,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,+BAA+B,CAAC,IAAY;IACzD,IAAI,CAAC;QACH,OAAO,MAAM,kBAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAA,kBAAS,GAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,uCAAuC,CAAC,CAAC;QAC5E,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,8BAA8B,CAAC,eAAmC;IAC/E,iEAAiE;IACjE,iDAAiD;IACjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,IAAA,cAAO,EAAC,4BAA4B,CAAC,IAAI,wDAAwD,EACjG;QACE,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,EAAE,GAAG,CAAC,eAAe,IAAI,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC,EAAE;KACxE,CACF,CAAC;IAEF,IAAI,YAAgC,CAAC;IACrC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,IAAA,kBAAS,GAAE,CAAC,IAAI,CACd,8FAA8F,CAC/F,CAAC;QAEF,YAAY;YACV,y7BAAy7B,CAAC;IAC97B,CAAC;IAED,YAAY,KAAM,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA8B,CAAC,YAAY,CAAC;IAEpF,OAAO,YAAY,CAAC;AACtB,CAAC"}
@@ -0,0 +1,55 @@
1
+ // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
+ import fs from 'fs/promises';
3
+ import { readEnv } from "./util.mjs";
4
+ import { getLogger } from "./logger.mjs";
5
+ const INSTRUCTIONS_CACHE_TTL_MS = 15 * 60 * 1000; // 15 minutes
6
+ const instructionsCache = new Map();
7
+ export async function getInstructions({ stainlessApiKey, customInstructionsPath, }) {
8
+ const now = Date.now();
9
+ const cacheKey = customInstructionsPath ?? stainlessApiKey ?? '';
10
+ const cached = instructionsCache.get(cacheKey);
11
+ if (cached && now - cached.fetchedAt <= INSTRUCTIONS_CACHE_TTL_MS) {
12
+ return cached.fetchedInstructions;
13
+ }
14
+ // Evict stale entries so the cache doesn't grow unboundedly.
15
+ for (const [key, entry] of instructionsCache) {
16
+ if (now - entry.fetchedAt > INSTRUCTIONS_CACHE_TTL_MS) {
17
+ instructionsCache.delete(key);
18
+ }
19
+ }
20
+ let fetchedInstructions;
21
+ if (customInstructionsPath) {
22
+ fetchedInstructions = await fetchLatestInstructionsFromFile(customInstructionsPath);
23
+ }
24
+ else {
25
+ fetchedInstructions = await fetchLatestInstructionsFromApi(stainlessApiKey);
26
+ }
27
+ instructionsCache.set(cacheKey, { fetchedInstructions, fetchedAt: now });
28
+ return fetchedInstructions;
29
+ }
30
+ async function fetchLatestInstructionsFromFile(path) {
31
+ try {
32
+ return await fs.readFile(path, 'utf-8');
33
+ }
34
+ catch (error) {
35
+ getLogger().error({ error, path }, 'Error fetching instructions from file');
36
+ throw error;
37
+ }
38
+ }
39
+ async function fetchLatestInstructionsFromApi(stainlessApiKey) {
40
+ // Setting the stainless API key is optional, but may be required
41
+ // to authenticate requests to the Stainless API.
42
+ const response = await fetch(readEnv('CODE_MODE_INSTRUCTIONS_URL') ?? 'https://api.stainless.com/api/ai/instructions/imagekit', {
43
+ method: 'GET',
44
+ headers: { ...(stainlessApiKey && { Authorization: stainlessApiKey }) },
45
+ });
46
+ let instructions;
47
+ if (!response.ok) {
48
+ getLogger().warn('Warning: failed to retrieve MCP server instructions. Proceeding with default instructions...');
49
+ instructions =
50
+ '\n This is the imagekit MCP server.\n\n Available tools:\n - search_docs: Search SDK documentation to find the right methods and parameters.\n - execute: Run TypeScript code against a pre-authenticated SDK client. Define an async run(client) function.\n\n Workflow:\n - If unsure about the API, call search_docs first.\n - Write complete solutions in a single execute call when possible. For large datasets, use API filters to narrow results or paginate within a single execute block.\n - If execute returns an error, read the error and fix your code rather than retrying the same approach.\n - Variables do not persist between execute calls. Return or log all data you need.\n - Individual HTTP requests to the API have a 30-second timeout. If a request times out, try a smaller query or add filters.\n - Code execution has a total timeout of approximately 5 minutes. If your code times out, simplify it or break it into smaller steps.\n ';
51
+ }
52
+ instructions ??= (await response.json()).instructions;
53
+ return instructions;
54
+ }
55
+ //# sourceMappingURL=instructions.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"instructions.mjs","sourceRoot":"","sources":["src/instructions.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,MAAM,aAAa;OACrB,EAAE,OAAO,EAAE;OACX,EAAE,SAAS,EAAE;AAEpB,MAAM,yBAAyB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AAO/D,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAkC,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EACpC,eAAe,EACf,sBAAsB,GAIvB;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,sBAAsB,IAAI,eAAe,IAAI,EAAE,CAAC;IACjE,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAE/C,IAAI,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,yBAAyB,EAAE,CAAC;QAClE,OAAO,MAAM,CAAC,mBAAmB,CAAC;IACpC,CAAC;IAED,6DAA6D;IAC7D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAC7C,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,yBAAyB,EAAE,CAAC;YACtD,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI,mBAA2B,CAAC;IAEhC,IAAI,sBAAsB,EAAE,CAAC;QAC3B,mBAAmB,GAAG,MAAM,+BAA+B,CAAC,sBAAsB,CAAC,CAAC;IACtF,CAAC;SAAM,CAAC;QACN,mBAAmB,GAAG,MAAM,8BAA8B,CAAC,eAAe,CAAC,CAAC;IAC9E,CAAC;IAED,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,mBAAmB,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACzE,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,+BAA+B,CAAC,IAAY;IACzD,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,uCAAuC,CAAC,CAAC;QAC5E,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,8BAA8B,CAAC,eAAmC;IAC/E,iEAAiE;IACjE,iDAAiD;IACjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,OAAO,CAAC,4BAA4B,CAAC,IAAI,wDAAwD,EACjG;QACE,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,EAAE,GAAG,CAAC,eAAe,IAAI,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC,EAAE;KACxE,CACF,CAAC;IAEF,IAAI,YAAgC,CAAC;IACrC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,SAAS,EAAE,CAAC,IAAI,CACd,8FAA8F,CAC/F,CAAC;QAEF,YAAY;YACV,y7BAAy7B,CAAC;IAC97B,CAAC;IAED,YAAY,KAAM,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA8B,CAAC,YAAY,CAAC;IAEpF,OAAO,YAAY,CAAC;AACtB,CAAC"}
@@ -0,0 +1,28 @@
1
+ type SearchResult = {
2
+ results: (string | Record<string, unknown>)[];
3
+ };
4
+ /**
5
+ * Self-contained local search engine backed by MiniSearch.
6
+ * Method data is embedded at SDK build time; prose documents
7
+ * can be loaded from an optional docs directory at runtime.
8
+ */
9
+ export declare class LocalDocsSearch {
10
+ private methodIndex;
11
+ private proseIndex;
12
+ private constructor();
13
+ static create(opts?: {
14
+ docsDir?: string;
15
+ }): Promise<LocalDocsSearch>;
16
+ search(props: {
17
+ query: string;
18
+ language?: string;
19
+ detail?: string;
20
+ maxResults?: number;
21
+ maxLength?: number;
22
+ }): SearchResult;
23
+ private indexMethods;
24
+ private loadDocsDirectory;
25
+ private indexProse;
26
+ }
27
+ export {};
28
+ //# sourceMappingURL=local-docs-search.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"local-docs-search.d.mts","sourceRoot":"","sources":["src/local-docs-search.ts"],"names":[],"mappings":"AA+CA,KAAK,YAAY,GAAG;IAClB,OAAO,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;CAC/C,CAAC;AA4gGF;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,UAAU,CAAiC;IAEnD,OAAO;WAKM,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAY1E,MAAM,CAAC,KAAK,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,YAAY;IA2EhB,OAAO,CAAC,YAAY;YAiBN,iBAAiB;IA4C/B,OAAO,CAAC,UAAU;CAgBnB"}
@@ -0,0 +1,28 @@
1
+ type SearchResult = {
2
+ results: (string | Record<string, unknown>)[];
3
+ };
4
+ /**
5
+ * Self-contained local search engine backed by MiniSearch.
6
+ * Method data is embedded at SDK build time; prose documents
7
+ * can be loaded from an optional docs directory at runtime.
8
+ */
9
+ export declare class LocalDocsSearch {
10
+ private methodIndex;
11
+ private proseIndex;
12
+ private constructor();
13
+ static create(opts?: {
14
+ docsDir?: string;
15
+ }): Promise<LocalDocsSearch>;
16
+ search(props: {
17
+ query: string;
18
+ language?: string;
19
+ detail?: string;
20
+ maxResults?: number;
21
+ maxLength?: number;
22
+ }): SearchResult;
23
+ private indexMethods;
24
+ private loadDocsDirectory;
25
+ private indexProse;
26
+ }
27
+ export {};
28
+ //# sourceMappingURL=local-docs-search.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"local-docs-search.d.ts","sourceRoot":"","sources":["src/local-docs-search.ts"],"names":[],"mappings":"AA+CA,KAAK,YAAY,GAAG;IAClB,OAAO,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;CAC/C,CAAC;AA4gGF;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,UAAU,CAAiC;IAEnD,OAAO;WAKM,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAY1E,MAAM,CAAC,KAAK,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,YAAY;IA2EhB,OAAO,CAAC,YAAY;YAiBN,iBAAiB;IA4C/B,OAAO,CAAC,UAAU;CAgBnB"}