@jrpool/kilotest 60.3.0 → 60.4.1

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 (8) hide show
  1. package/lhm.plugin.json +1 -1
  2. package/mcp.ts +3 -3
  3. package/openapi-3.0.yaml +1 -1
  4. package/openapi.yaml +1 -1
  5. package/package.json +1 -1
  6. package/server.json +1 -1
  7. package/web/home/index.html +2 -2
  8. package/web/tutorialAI/index.html +37 -39
package/lhm.plugin.json CHANGED
@@ -4423,5 +4423,5 @@
4423
4423
  }
4424
4424
  }
4425
4425
  ],
4426
- "version": "60.3.0"
4426
+ "version": "60.4.1"
4427
4427
  }
package/mcp.ts CHANGED
@@ -61,9 +61,9 @@ const sharedContext = 'Kilotest integrates an ensemble of 12 rule engines, with
61
61
  const kilotestOverview = [
62
62
  'Kilotest tests web pages for front-end quality: accessibility, usability, and web standards, including HTML, CSS, ARIA, and WCAG.',
63
63
  'Kilotest integrates an ensemble of twelve independent rule engines to test a web page and stores the results as a structured report.',
64
- 'Results are organized as a hierarchy. A tested page has one or more reports, from oldest to latest. A report contains issues. An issue has violators: elements of the tested page reported as exhibiting the issue. A violator has diagnoses: explanations from rule engines of how the element exhibited the issue.',
65
- 'Typical workflow: call the listPages tool to learn whether the page has been tested. If it has, drill down from its latest report with the listIssues, listViolators, and listDiagnoses tools, or retrieve the entire report with the getReport tool. The listIssues output also lists all reports about the same page, so you can examine earlier reports. If the page has not been tested, request a test with the requestNewTest tool. If the latest report is obsolete, request a retest with the requestRetest tool.',
66
- 'For immediate, automatically approved testing, use the orderNewTest tool (for a new page) or the orderRetest tool (for a page with an obsolete report) instead of requestNewTest or requestRetest. Each enqueues the job right away, with no manual approval step, and returns a report identifier along with a question about whether to wait for completion. To wait, call the awaitTest tool with that identifier; it blocks until the report is ready, the job fails, or a maximum wait time elapses. To check later instead, call the listIssues tool with the same identifier.',
64
+ 'Results are organized as a hierarchy: tested pages; for each tested page, reports from the tests of the page; for each report, issues reported; for each issue, violators of rules belonging to the issue (a violator is an element or the whole page); for each violator, diagnoses by rule engines of its violations.',
65
+ 'Typical workflow: call the listPages tool to learn whether the page has been tested. If it has, drill down from its latest report with the listIssues, listViolators, and listDiagnoses tools, or retrieve the entire report with the getReport tool. The listIssues output also lists all reports about the same page, so you can examine earlier reports. If the page has not been tested, request a test with the requestNewTest tool or order a test with the orderNewTest tool. If the latest report is obsolete, request a retest with the requestRetest tool or order a retest with the orderRetest tool.',
66
+ 'The request tools submit requests for manager approval. The order tools obtain automated review and approval or rejection. Approval produces a report identifier and an opportunity to wait for completion. To wait, call the awaitTest tool with that identifier; it blocks until the report is ready, the job fails, or a maximum wait time elapses. To check later instead, call the listIssues tool with the same identifier.',
67
67
  'More documentation is available at https://kilotest.com/llms.txt and https://kilotest.com/llms-full.txt.'
68
68
  ].join('\n\n');
69
69
 
package/openapi-3.0.yaml CHANGED
@@ -2,7 +2,7 @@ openapi: 3.0.3
2
2
  info:
3
3
  title: Kilotest API
4
4
  description: 'Kilotest is an ensemble testing and reporting service for front-end web quality. It uses an ensemble of 12 rule engines to test web pages for front-end quality (accessibility, usability, and web standards, including HTML, CSS, ARIA, and WCAG). Kilotest acts as a web server for human users, an MCP server for AI platforms, and an API for programmatic access. With this API you can request that a page be tested or retested, discover available reports, incrementally retrieve facts from a report: from what reports are available, to what issues were reported in one report, to what elements violated one issue, to what diagnoses rule engines gave for one violation.'
5
- version: 60.3.0
5
+ version: 60.4.1
6
6
  license:
7
7
  name: MIT
8
8
  url: https://github.com/jrpool/kilotest/blob/main/LICENSE
package/openapi.yaml CHANGED
@@ -2,7 +2,7 @@ openapi: 3.1.0
2
2
  info:
3
3
  title: Kilotest API
4
4
  description: 'Kilotest is an ensemble testing and reporting service for front-end web quality. It uses an ensemble of 12 rule engines to test web pages for front-end quality (accessibility, usability, and web standards, including HTML, CSS, ARIA, and WCAG). Kilotest acts as a web server for human users, an MCP server for AI platforms, and an API for programmatic access. With this API you can request that a page be tested or retested, discover available reports, incrementally retrieve facts from a report: from what reports are available, to what issues were reported in one report, to what elements violated one issue, to what diagnoses rule engines gave for one violation.'
5
- version: 60.3.0
5
+ version: 60.4.1
6
6
  license:
7
7
  name: MIT
8
8
  identifier: MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jrpool/kilotest",
3
- "version": "60.3.0",
3
+ "version": "60.4.1",
4
4
  "description": "Ensemble testing for front-end web quality",
5
5
  "type": "module",
6
6
  "main": "index.ts",
package/server.json CHANGED
@@ -6,7 +6,7 @@
6
6
  "url": "https://github.com/jrpool/kilotest",
7
7
  "source": "github"
8
8
  },
9
- "version": "60.3.0",
9
+ "version": "60.4.1",
10
10
  "remotes": [
11
11
  {
12
12
  "type": "streamable-http",
package/web/home/index.html CHANGED
@@ -77,9 +77,9 @@
77
77
  <h2>Who are you?</h2>
78
78
  <h3>If you are a human user on the web</h3>
79
79
  <p>You can use Kilotest starting on this page.</p>
80
- <p>If your main interest is accessibility, feel free to learn more about it with our <a href="/tutorialWeb.html">tutorial</a>.</p>
80
+ <p>There is an <a href="/tutorialWeb.html">in-depth explanation of how Kilotest tests for accessibility</a>.</p>
81
81
  <h3>If you are a human user of AI</h3>
82
- <p>An AI assistant can use the Kilotest MCP server to give you precise answers about the front-end quality of a web page. If the AI assistant does not already have permission to use Kilotest, you can grant that permission. <a href="/tutorialAI.html">Learn how to connect AI platforms to Kilotest</a>.</p>
82
+ <p>An AI assistant can use Kilotest to analyze the quality of a web page more precisely and comprehensively. There is a <a href="/tutorialAI.html">step-by-step guide on using Kilotest with AI</a>.</p>
83
83
  <h3>If you are an AI agent or model</h3>
84
84
  <p>Go to the <a href="/mcp">Kilotest MCP server</a>.</p>
85
85
  <h3>If you are developing an application</h3>
package/web/tutorialAI/index.html CHANGED
@@ -4,38 +4,35 @@
4
4
  __head__
5
5
  <meta name="keywords" content="large language models,tools,model context protocol">
6
6
  <meta name="description" content="Kilotest tutorial: how to connect an AI platform to Kilotest for technical analysis">
7
- <title>Connect an AI Platform | Kilotest</title>
7
+ <title>Kilotest and AI</title>
8
8
  </head>
9
9
  <body class="styled">
10
10
  __header__
11
11
  <main class="page">
12
- <h1>Connect an AI Platform</h1>
13
- <h2>Purpose</h2>
14
- <p>This tutorial shows you how to make Kilotest available to assistants powered by artificial intelligence. Suppose:</p>
15
- <ul>
16
- <li>You use an AI platform, like ChatGPT, Claude, Gemini, Grok, Manus, Mistral Vibe, or Perplexity Pro.</li>
17
- <li>You want to audit the quality of a web page.</li>
18
- </ul>
19
- <p>Then the models on your AI platform can use Kilotest <strong>if</strong> you make Kilotest available on the platform.</p>
20
- <h2>Platform instructions</h2>
12
+ <h1>Kilotest and AI</h1>
13
+ <h2>Introduction</h2>
14
+ <p>Kilotest is designed for use by artificial intelligence. When you ask AI assistants to help you diagnose and improve web quality, they can use Kilotest for the most complete and accurate results. This guide tells you how to make Kilotest available on AI platforms.</p>
15
+ <h2>Step-by-step instructions</h2>
21
16
  <details id="chatgpt">
22
- <summary>ChatGPT Plus or Pro in a browser</summary>
23
- <p>These instructions apply to <a href="https://chatgpt.com">ChatGPT</a> on the Plus or Pro plan. Custom-app support on consumer plans is new and still changing; these instructions will be simplified once Kilotest is listed in the ChatGPT app directory.</p>
17
+ <summary>ChatGPT</summary>
18
+ <p>These instructions apply to <a href="https://chatgpt.com">ChatGPT</a>Plus and Pro plans used in a web browser.</p>
24
19
  <ol>
25
- <li>Open the <q>Plugins</q> page.</li>
26
- <li>Click the <q>+</q> button.</li>
27
- <li>Click <q>Add custom MCP server</q>.</li>
28
- <li>Enter <q>Kilotest</q> into the <q>Name</q> input.</li>
29
- <li>Under <q>Connection</q>, enter <q>https://kilotest.com/mcp</q> into the <q>Server URL</q> input.</li>
30
- <li>Set the authentication to <q>No authentication</q>.</li>
31
- <li>Check the <q>I understand and want to continue</q> checkbox.</li>
32
- <li>Click the <q>Create as a plugin</q> button.</li>
33
- <li>Review the discovered tools and metadata, then install the plugin.</li>
20
+ <li>Click <q>Plugins</q> in the sidebar.</li>
21
+ <li>In the <q>Add</q> list, select <q>Add custom MCP server</q>.</li>
22
+ <li>Enter <q>Kilotest</q> as the <q>Name</q>.</li>
23
+ <li>Enter <q>Test web-page quality</q> as the <q>Description</q>.</li>
24
+ <li>Enter <q>https://kilotest.com/mcp</q> as the Server URL <q>Connection</q>.</li>
25
+ <li>Set the <q>Authentication</q> to <q>No authentication</q>.</li>
26
+ <li>Check <q>I understand and want to continue</q>.</li>
27
+ <li>Click <q>Create as a plugin</q>.</li>
28
+ <li>Wait for the plugin to load.</li>
29
+ <li>Click <q>Connect Kilotest</q>.</li>
30
+ <li><q>Kilotest is now connected</q> will appear and disappear.</li>
34
31
  </ol>
35
- <p>To use Kilotest in a conversation, enter <q>@</q> in the prompt input and select <q>Kilotest</q>.</p>
32
+ <p>ChatGPT can then use Kilotest to answer your questions. To say you want it used, you can enter <q>@ Kilotest</q> as the start of any message.</p>
36
33
  </details>
37
34
  <details id="claude">
38
- <summary>Claude.ai in a browser or Claude Desktop</summary>
35
+ <summary>Claude</summary>
39
36
  <p>These instructions apply to <a href="https://claude.ai">Claude.ai in a browser</a> and <a href="https://downloads.claude.com">Claude Desktop</a>.</p>
40
37
  <ol>
41
38
  <li><a href="https://claude.ai/new">Start a new task</a>.</li>
@@ -49,8 +46,8 @@
49
46
  </ol>
50
47
  </details>
51
48
  <details id="gemini">
52
- <summary>Google Gemini in a browser</summary>
53
- <p>These instructions apply to <a href="https://gemini.google.com">Gemini</a> if you are at least 18 years old, are in the United States, are signed in to a personal (not a work or school) Google Account with the <q>Keep Activity</q> setting on, and are using English. Google is rolling out custom apps gradually; on some plans the <q>Custom apps</q> section requires a Google AI Pro or Ultra subscription.</p>
49
+ <summary>Gemini</summary>
50
+ <p>These instructions apply to Google <a href="https://gemini.google.com">Gemini</a> in a browser, if you are at least 18 years old, are in the United States, are signed in to a personal (not a work or school) Google Account with the <q>Keep Activity</q> setting on, and are using English. Google is rolling out custom apps gradually; on some plans the <q>Custom apps</q> section requires a Google AI Pro or Ultra subscription.</p>
54
51
  <ol>
55
52
  <li>Click the <q>Settings</q> button at the bottom left.</li>
56
53
  <li>Click <q>Connected Apps</q>. If you do not see it, click <q>Personal Intelligence</q> first.</li>
@@ -85,21 +82,8 @@
85
82
  <li>Save the connector.</li>
86
83
  </ol>
87
84
  </details>
88
- <details id="vibe">
89
- <summary>Mistral Vibe</summary>
90
- <ol>
91
- <li>Choose the <a href="https://chat.mistral.ai/work">Work tab</a>.</li>
92
- <li>Click <q>Connect your apps for better answers</q>.</li>
93
- <li>Click the <q>+ Add connector</q> button.</li>
94
- <li>Click the <q>Add a custom connector</q> button.</li>
95
- <li>Enter <q>Kilotest</q> into the <q>Connector name</q> input.</li>
96
- <li>Enter <q>https://kilotest.com/mcp</q> into the <q>Server</q> input.</li>
97
- <li>Click the <q>Add connector</q> button.</li>
98
- <li>Toggle the <q>Ask/Allow</q> buttons to show <q>Allow</q>.</li>
99
- </ol>
100
- </details>
101
85
  <details id="perplexity">
102
- <summary>Perplexity Pro in a browser</summary>
86
+ <summary>Perplexity</summary>
103
87
  <p>These instructions apply to <a href="https://www.perplexity.ai/">Perplexity</a> Pro in a browser.</p>
104
88
  <ol>
105
89
  <li>After signing in, open the <q>Plugins</q> menu.</li>
@@ -113,6 +97,20 @@
113
97
  </ol>
114
98
  <p>Once you add Kilotest, it <strong>may</strong> become available in the Perplexity app on your computer or mobile device, too.</p>
115
99
  </details>
100
+ <details id="vibe">
101
+ <summary>Vibe</summary>
102
+ <p>These instructions apply to Mistral <a href="https://chat.mistral.ai/work">Vibe</a>.</p>
103
+ <ol>
104
+ <li>Choose the Work tab.</li>
105
+ <li>Click <q>Connect your apps for better answers</q>.</li>
106
+ <li>Click the <q>+ Add connector</q> button.</li>
107
+ <li>Click the <q>Add a custom connector</q> button.</li>
108
+ <li>Enter <q>Kilotest</q> into the <q>Connector name</q> input.</li>
109
+ <li>Enter <q>https://kilotest.com/mcp</q> into the <q>Server</q> input.</li>
110
+ <li>Click the <q>Add connector</q> button.</li>
111
+ <li>Toggle the <q>Ask/Allow</q> buttons to show <q>Allow</q>.</li>
112
+ </ol>
113
+ </details>
116
114
  <h2 id="other">Other AI platforms</h2>
117
115
  <p>You can connect Kilotest to some other AI platforms, too. The instructions above are limited to consumer platforms that are either free or relatively inexpensive (US$20 per month or less). Business platforms such as ChatGPT Business, and developer platforms such as Devin Desktop, also permit you to enable Kilotest.</p>
118
116
  <p>Feel free to submit a comment below about empowering any AI platform to use Kilotest.</p>