@appium/mcp-documentation 1.0.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 (88) hide show
  1. package/CHANGELOG.md +0 -0
  2. package/LICENSE +201 -0
  3. package/README.md +126 -0
  4. package/dist/answer-appium.d.ts +8 -0
  5. package/dist/answer-appium.d.ts.map +1 -0
  6. package/dist/answer-appium.js +38 -0
  7. package/dist/answer-appium.js.map +1 -0
  8. package/dist/appium-skills.d.ts +5 -0
  9. package/dist/appium-skills.d.ts.map +1 -0
  10. package/dist/appium-skills.js +168 -0
  11. package/dist/appium-skills.js.map +1 -0
  12. package/dist/index.d.ts +31 -0
  13. package/dist/index.d.ts.map +1 -0
  14. package/dist/index.js +69 -0
  15. package/dist/index.js.map +1 -0
  16. package/dist/logger.d.ts +4 -0
  17. package/dist/logger.d.ts.map +1 -0
  18. package/dist/logger.js +5 -0
  19. package/dist/logger.js.map +1 -0
  20. package/dist/markdown-header-splitter.d.ts +32 -0
  21. package/dist/markdown-header-splitter.d.ts.map +1 -0
  22. package/dist/markdown-header-splitter.js +180 -0
  23. package/dist/markdown-header-splitter.js.map +1 -0
  24. package/dist/paths.d.ts +2 -0
  25. package/dist/paths.d.ts.map +1 -0
  26. package/dist/paths.js +22 -0
  27. package/dist/paths.js.map +1 -0
  28. package/dist/plugin.d.ts +19 -0
  29. package/dist/plugin.d.ts.map +1 -0
  30. package/dist/plugin.js +18 -0
  31. package/dist/plugin.js.map +1 -0
  32. package/dist/reasoning-rag.d.ts +89 -0
  33. package/dist/reasoning-rag.d.ts.map +1 -0
  34. package/dist/reasoning-rag.js +282 -0
  35. package/dist/reasoning-rag.js.map +1 -0
  36. package/dist/scripts/eval-documentation-rag.d.ts +50 -0
  37. package/dist/scripts/eval-documentation-rag.d.ts.map +1 -0
  38. package/dist/scripts/eval-documentation-rag.js +287 -0
  39. package/dist/scripts/eval-documentation-rag.js.map +1 -0
  40. package/dist/scripts/generate-embeddings-cache.d.ts +13 -0
  41. package/dist/scripts/generate-embeddings-cache.d.ts.map +1 -0
  42. package/dist/scripts/generate-embeddings-cache.js +24 -0
  43. package/dist/scripts/generate-embeddings-cache.js.map +1 -0
  44. package/dist/scripts/rag-eval-dataset.json +516 -0
  45. package/dist/scripts/simple-index-documentation.d.ts +21 -0
  46. package/dist/scripts/simple-index-documentation.d.ts.map +1 -0
  47. package/dist/scripts/simple-index-documentation.js +77 -0
  48. package/dist/scripts/simple-index-documentation.js.map +1 -0
  49. package/dist/scripts/simple-query-documentation.d.ts +13 -0
  50. package/dist/scripts/simple-query-documentation.d.ts.map +1 -0
  51. package/dist/scripts/simple-query-documentation.js +52 -0
  52. package/dist/scripts/simple-query-documentation.js.map +1 -0
  53. package/dist/sentence-transformers-embeddings.d.ts +40 -0
  54. package/dist/sentence-transformers-embeddings.d.ts.map +1 -0
  55. package/dist/sentence-transformers-embeddings.js +119 -0
  56. package/dist/sentence-transformers-embeddings.js.map +1 -0
  57. package/dist/simple-pdf-indexer.d.ts +47 -0
  58. package/dist/simple-pdf-indexer.d.ts.map +1 -0
  59. package/dist/simple-pdf-indexer.js +572 -0
  60. package/dist/simple-pdf-indexer.js.map +1 -0
  61. package/dist/tests/__mocks__/@appium/support.d.ts +92 -0
  62. package/dist/tests/__mocks__/@appium/support.d.ts.map +1 -0
  63. package/dist/tests/__mocks__/@appium/support.js +66 -0
  64. package/dist/tests/__mocks__/@appium/support.js.map +1 -0
  65. package/dist/tests/appium-skills.test.d.ts +2 -0
  66. package/dist/tests/appium-skills.test.d.ts.map +1 -0
  67. package/dist/tests/appium-skills.test.js +26 -0
  68. package/dist/tests/appium-skills.test.js.map +1 -0
  69. package/dist/tests/plugin.test.d.ts +2 -0
  70. package/dist/tests/plugin.test.d.ts.map +1 -0
  71. package/dist/tests/plugin.test.js +18 -0
  72. package/dist/tests/plugin.test.js.map +1 -0
  73. package/dist/tests/simple-pdf-indexer.test.d.ts +2 -0
  74. package/dist/tests/simple-pdf-indexer.test.d.ts.map +1 -0
  75. package/dist/tests/simple-pdf-indexer.test.js +37 -0
  76. package/dist/tests/simple-pdf-indexer.test.js.map +1 -0
  77. package/dist/tool-response.d.ts +4 -0
  78. package/dist/tool-response.d.ts.map +1 -0
  79. package/dist/tool-response.js +12 -0
  80. package/dist/tool-response.js.map +1 -0
  81. package/dist/tools.d.ts +3 -0
  82. package/dist/tools.d.ts.map +1 -0
  83. package/dist/tools.js +3 -0
  84. package/dist/tools.js.map +1 -0
  85. package/dist/uploads/documents.json +1 -0
  86. package/package.json +84 -0
  87. package/scripts/zip-assets.mjs +75 -0
  88. package/src/resources/submodules.zip +0 -0
@@ -0,0 +1,92 @@
1
+ export declare const logger: {
2
+ getLogger: (_name: string) => {
3
+ debug: () => void;
4
+ info: () => void;
5
+ warn: () => void;
6
+ error: () => void;
7
+ trace: () => void;
8
+ };
9
+ };
10
+ export declare const fs: {
11
+ hasAccess: (p: string) => Promise<boolean>;
12
+ exists: (p: string) => Promise<boolean>;
13
+ readdir: (p: string) => Promise<string[]>;
14
+ stat: (p: string) => Promise<import("node:fs").Stats>;
15
+ readFile: (p: string, encoding?: BufferEncoding) => Promise<string | NonSharedBuffer>;
16
+ writeFile: (p: string, data: string | Buffer, encoding?: BufferEncoding) => Promise<void>;
17
+ unlink: (p: string) => Promise<void>;
18
+ rename: (from: string, to: string) => Promise<void>;
19
+ mkdir: (p: string, opts?: {
20
+ recursive?: boolean;
21
+ }) => Promise<string | undefined>;
22
+ mkdirp: (p: string) => Promise<string | undefined>;
23
+ mv: (from: string, to: string) => Promise<void>;
24
+ };
25
+ export declare const imageUtil: {
26
+ requireSharp: () => never;
27
+ };
28
+ export declare const util: {
29
+ wrapElement: (elementId: string) => {
30
+ ELEMENT: string;
31
+ 'element-6066-11e4-a52e-4f735466cecf': string;
32
+ };
33
+ };
34
+ export declare const net: {
35
+ downloadFile: () => Promise<void>;
36
+ };
37
+ export declare const plist: {
38
+ parsePlistFile: () => Promise<{}>;
39
+ };
40
+ export declare const zip: {
41
+ extractAllTo: () => Promise<void>;
42
+ readEntries: () => Promise<void>;
43
+ toArchive: () => Promise<void>;
44
+ };
45
+ declare const _default: {
46
+ logger: {
47
+ getLogger: (_name: string) => {
48
+ debug: () => void;
49
+ info: () => void;
50
+ warn: () => void;
51
+ error: () => void;
52
+ trace: () => void;
53
+ };
54
+ };
55
+ fs: {
56
+ hasAccess: (p: string) => Promise<boolean>;
57
+ exists: (p: string) => Promise<boolean>;
58
+ readdir: (p: string) => Promise<string[]>;
59
+ stat: (p: string) => Promise<import("node:fs").Stats>;
60
+ readFile: (p: string, encoding?: BufferEncoding) => Promise<string | NonSharedBuffer>;
61
+ writeFile: (p: string, data: string | Buffer, encoding?: BufferEncoding) => Promise<void>;
62
+ unlink: (p: string) => Promise<void>;
63
+ rename: (from: string, to: string) => Promise<void>;
64
+ mkdir: (p: string, opts?: {
65
+ recursive?: boolean;
66
+ }) => Promise<string | undefined>;
67
+ mkdirp: (p: string) => Promise<string | undefined>;
68
+ mv: (from: string, to: string) => Promise<void>;
69
+ };
70
+ imageUtil: {
71
+ requireSharp: () => never;
72
+ };
73
+ util: {
74
+ wrapElement: (elementId: string) => {
75
+ ELEMENT: string;
76
+ 'element-6066-11e4-a52e-4f735466cecf': string;
77
+ };
78
+ };
79
+ net: {
80
+ downloadFile: () => Promise<void>;
81
+ };
82
+ plist: {
83
+ parsePlistFile: () => Promise<{}>;
84
+ };
85
+ zip: {
86
+ extractAllTo: () => Promise<void>;
87
+ readEntries: () => Promise<void>;
88
+ toArchive: () => Promise<void>;
89
+ };
90
+ };
91
+ export default _default;
92
+ //# sourceMappingURL=support.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"support.d.ts","sourceRoot":"","sources":["../../../../src/tests/__mocks__/@appium/support.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,MAAM;uBACE,MAAM;;;;;;;CAO1B,CAAC;AAEF,eAAO,MAAM,EAAE;mBACQ,MAAM;gBAQT,MAAM;iBACX,MAAM;cACT,MAAM;kBACF,MAAM,aAAa,cAAc;mBAEhC,MAAM,QAAQ,MAAM,GAAG,MAAM,aAAa,cAAc;gBAE3D,MAAM;mBACH,MAAM,MAAM,MAAM;eACtB,MAAM,SAAS;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE;gBAErC,MAAM;eACD,MAAM,MAAM,MAAM;CAGpC,CAAC;AAEF,eAAO,MAAM,SAAS;;CAIrB,CAAC;AAEF,eAAO,MAAM,IAAI;6BACU,MAAM;;;;CAIhC,CAAC;AAEF,eAAO,MAAM,GAAG;;CAEf,CAAC;AAEF,eAAO,MAAM,KAAK;;CAEjB,CAAC;AAEF,eAAO,MAAM,GAAG;;;;CAIf,CAAC;;;2BA5DmB,MAAM;;;;;;;;;uBAUJ,MAAM;oBAQT,MAAM;qBACX,MAAM;kBACT,MAAM;sBACF,MAAM,aAAa,cAAc;uBAEhC,MAAM,QAAQ,MAAM,GAAG,MAAM,aAAa,cAAc;oBAE3D,MAAM;uBACH,MAAM,MAAM,MAAM;mBACtB,MAAM,SAAS;YAAE,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE;oBAErC,MAAM;mBACD,MAAM,MAAM,MAAM;;;;;;iCAYV,MAAM;;;;;;;;;;;;;;;;;AAoBjC,wBAQE"}
@@ -0,0 +1,66 @@
1
+ import { constants, existsSync, promises as fsPromises } from 'node:fs';
2
+ const noop = () => { };
3
+ export const logger = {
4
+ getLogger: (_name) => ({
5
+ debug: noop,
6
+ info: noop,
7
+ warn: noop,
8
+ error: noop,
9
+ trace: noop,
10
+ }),
11
+ };
12
+ export const fs = {
13
+ hasAccess: async (p) => {
14
+ try {
15
+ await fsPromises.access(p, constants.R_OK);
16
+ return true;
17
+ }
18
+ catch {
19
+ return false;
20
+ }
21
+ },
22
+ exists: async (p) => existsSync(p),
23
+ readdir: (p) => fsPromises.readdir(p),
24
+ stat: (p) => fsPromises.stat(p),
25
+ readFile: (p, encoding) => fsPromises.readFile(p, encoding),
26
+ writeFile: (p, data, encoding) => fsPromises.writeFile(p, data, encoding),
27
+ unlink: (p) => fsPromises.unlink(p),
28
+ rename: (from, to) => fsPromises.rename(from, to),
29
+ mkdir: (p, opts) => fsPromises.mkdir(p, opts),
30
+ mkdirp: (p) => fsPromises.mkdir(p, { recursive: true }),
31
+ mv: async (from, to) => {
32
+ await fsPromises.rename(from, to);
33
+ },
34
+ };
35
+ export const imageUtil = {
36
+ requireSharp: () => {
37
+ throw new Error('imageUtil.requireSharp must be mocked by the test');
38
+ },
39
+ };
40
+ export const util = {
41
+ wrapElement: (elementId) => ({
42
+ ELEMENT: elementId,
43
+ 'element-6066-11e4-a52e-4f735466cecf': elementId,
44
+ }),
45
+ };
46
+ export const net = {
47
+ downloadFile: async () => { },
48
+ };
49
+ export const plist = {
50
+ parsePlistFile: async () => ({}),
51
+ };
52
+ export const zip = {
53
+ extractAllTo: async () => { },
54
+ readEntries: async () => { },
55
+ toArchive: async () => { },
56
+ };
57
+ export default {
58
+ logger,
59
+ fs,
60
+ imageUtil,
61
+ util,
62
+ net,
63
+ plist,
64
+ zip,
65
+ };
66
+ //# sourceMappingURL=support.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"support.js","sourceRoot":"","sources":["../../../../src/tests/__mocks__/@appium/support.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=appium-skills.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"appium-skills.test.d.ts","sourceRoot":"","sources":["../../src/tests/appium-skills.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,26 @@
1
+ import { describe, expect, test } from '@jest/globals';
2
+ import { appiumSkillsTool } from '../appium-skills.js';
3
+ async function runTool(args) {
4
+ const result = await appiumSkillsTool.execute(args, {});
5
+ return result.content[0].text;
6
+ }
7
+ describe('appium_skills tool contract', () => {
8
+ test('returns Android UiAutomator2 setup skills', async () => {
9
+ const text = await runTool({
10
+ platform: 'android',
11
+ driver: 'uiautomator2',
12
+ mode: 'setup',
13
+ });
14
+ expect(text).toContain('Appium skills for android/uiautomator2');
15
+ expect(text).toContain('Recommended skill order:');
16
+ expect(text).toContain('skills/environment-setup-android/SKILL.md');
17
+ });
18
+ test('rejects unsupported troubleshooting driver path', async () => {
19
+ await expect(appiumSkillsTool.execute({
20
+ platform: 'android',
21
+ driver: 'espresso',
22
+ mode: 'troubleshoot',
23
+ }, {})).rejects.toThrow('Troubleshooting guidance is currently scoped');
24
+ });
25
+ });
26
+ //# sourceMappingURL=appium-skills.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"appium-skills.test.js","sourceRoot":"","sources":["../../src/tests/appium-skills.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,KAAK,UAAU,OAAO,CAAC,IAAS;IAC9B,MAAM,MAAM,GAAG,MAAO,gBAAgB,CAAC,OAAe,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACjE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAc,CAAC;AAC1C,CAAC;AAED,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,IAAI,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;YACzB,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,cAAc;YACtB,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,wCAAwC,CAAC,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,2CAA2C,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,MAAM,CACT,gBAAgB,CAAC,OAAe,CAC/B;YACE,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,cAAc;SACrB,EACD,EAAE,CACH,CACF,CAAC,OAAO,CAAC,OAAO,CAAC,8CAA8C,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=plugin.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin.test.d.ts","sourceRoot":"","sources":["../../src/tests/plugin.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,18 @@
1
+ import { describe, expect, test } from '@jest/globals';
2
+ import { AppiumDocumentation, appiumDocumentationQueryTool, appiumSkillsTool, } from '../index.js';
3
+ describe('AppiumDocumentation plugin', () => {
4
+ test('registers documentation tools', () => {
5
+ const tools = [];
6
+ const registry = {
7
+ addTool(toolDef) {
8
+ tools.push(toolDef);
9
+ },
10
+ };
11
+ const plugin = new AppiumDocumentation();
12
+ plugin.register(registry);
13
+ expect(plugin.name).toBe('appium-documentation');
14
+ expect(plugin.version).toBe('1.0.0');
15
+ expect(tools).toEqual([appiumDocumentationQueryTool, appiumSkillsTool]);
16
+ });
17
+ });
18
+ //# sourceMappingURL=plugin.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin.test.js","sourceRoot":"","sources":["../../src/tests/plugin.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAOrB,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,IAAI,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACzC,MAAM,KAAK,GAAc,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG;YACf,OAAO,CAAC,OAAgB;gBACtB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,CAAC;SACF,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;QACzC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAE1B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACjD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,4BAA4B,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=simple-pdf-indexer.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"simple-pdf-indexer.test.d.ts","sourceRoot":"","sources":["../../src/tests/simple-pdf-indexer.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,37 @@
1
+ import { describe, expect, test, afterEach } from '@jest/globals';
2
+ import fs from 'node:fs';
3
+ import os from 'node:os';
4
+ import path from 'node:path';
5
+ import { getMarkdownFilesInDirectory } from '../simple-pdf-indexer.js';
6
+ const tempDirs = [];
7
+ afterEach(() => {
8
+ while (tempDirs.length > 0) {
9
+ const dir = tempDirs.pop();
10
+ if (dir) {
11
+ fs.rmSync(dir, { recursive: true, force: true });
12
+ }
13
+ }
14
+ });
15
+ function makeTempDir() {
16
+ const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'appium-mcp-docs-'));
17
+ tempDirs.push(dir);
18
+ return dir;
19
+ }
20
+ describe('getMarkdownFilesInDirectory', () => {
21
+ test('returns markdown files and excludes appium-skills content', async () => {
22
+ const root = makeTempDir();
23
+ const docsDir = path.join(root, 'docs');
24
+ const skillsDir = path.join(root, 'appium-skills');
25
+ const nestedSkillsDir = path.join(skillsDir, 'skills', 'android');
26
+ fs.mkdirSync(docsDir, { recursive: true });
27
+ fs.mkdirSync(nestedSkillsDir, { recursive: true });
28
+ fs.writeFileSync(path.join(root, 'README.md'), '# Root');
29
+ fs.writeFileSync(path.join(docsDir, 'guide.md'), '# Guide');
30
+ fs.writeFileSync(path.join(docsDir, 'ignore.txt'), 'ignore');
31
+ fs.writeFileSync(path.join(nestedSkillsDir, 'SKILL.md'), '# Skill');
32
+ const markdownFiles = await getMarkdownFilesInDirectory(root);
33
+ const relativeFiles = markdownFiles.map((file) => path.relative(root, file));
34
+ expect(relativeFiles.sort()).toEqual(['README.md', 'docs/guide.md']);
35
+ });
36
+ });
37
+ //# sourceMappingURL=simple-pdf-indexer.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"simple-pdf-indexer.test.js","sourceRoot":"","sources":["../../src/tests/simple-pdf-indexer.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE,MAAM,QAAQ,GAAa,EAAE,CAAC;AAE9B,SAAS,CAAC,GAAG,EAAE;IACb,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC;QAC3B,IAAI,GAAG,EAAE,CAAC;YACR,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,SAAS,WAAW;IAClB,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACvE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,IAAI,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QACnD,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAElE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,EAAE,CAAC,SAAS,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;QACzD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC;QAC5D,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC7D,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC;QAEpE,MAAM,aAAa,GAAG,MAAM,2BAA2B,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,aAAa,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC/C,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAC1B,CAAC;QAEF,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { ContentResult } from 'fastmcp';
2
+ export declare function textResult(text: string): ContentResult;
3
+ export declare function errorResult(text: string): ContentResult;
4
+ //# sourceMappingURL=tool-response.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-response.d.ts","sourceRoot":"","sources":["../src/tool-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAItD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAKvD"}
@@ -0,0 +1,12 @@
1
+ export function textResult(text) {
2
+ return {
3
+ content: [{ type: 'text', text }],
4
+ };
5
+ }
6
+ export function errorResult(text) {
7
+ return {
8
+ content: [{ type: 'text', text }],
9
+ isError: true,
10
+ };
11
+ }
12
+ //# sourceMappingURL=tool-response.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-response.js","sourceRoot":"","sources":["../src/tool-response.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}
@@ -0,0 +1,3 @@
1
+ export { appiumDocumentationQueryTool } from './answer-appium.js';
2
+ export { appiumSkillsTool } from './appium-skills.js';
3
+ //# sourceMappingURL=tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}
package/dist/tools.js ADDED
@@ -0,0 +1,3 @@
1
+ export { appiumDocumentationQueryTool } from './answer-appium.js';
2
+ export { appiumSkillsTool } from './appium-skills.js';
3
+ //# sourceMappingURL=tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}