@modootoday/pmcp 0.13.1 → 0.14.0

package/plugins/msw-2/skills/msw/SKILL.md

@@ -0,0 +1,182 @@
+---
+name: msw
+description: Use MSW 2.x for HTTP and GraphQL request interception. Covers the v2 API, Node setup, response construction, resolver inputs, migration traps from MSW 1.x, and the browser entry point.
+---
+
+Verified against msw@2.15.0 on 2026-09-08. 3 of 3 examples executed.
+
+# MSW 2.x
+
+Use this skill for `msw` in the `^2.0.0` range. MSW 2 requires Node.js 18+ and TypeScript 4.7+. The primary v2 imports are `http`, `graphql`, and `HttpResponse` from `msw`; environment-specific setup is imported from `msw/node` or `msw/browser`.
+
+## The v2 shape
+
+HTTP handlers use the `http` namespace and receive one resolver-information object:
+
+```ts
+import { http, HttpResponse } from 'msw'
+
+const handlers = [
+  http.get('/user/:id', ({ params }) => {
+    return HttpResponse.json({ id: params.id })
+  }),
+  http.post('/user', async ({ request }) => {
+    const body = await request.json()
+    return HttpResponse.json(body, { status: 201 })
+  }),
+]
+```
+
+A handler by itself does not intercept anything. Pass handlers to `setupServer(...handlers)` in Node or `setupWorker(...handlers)` in a browser.
+
+`HttpResponse.json(value, options?)` creates a response. The options can include `status` and `statusText`. `HttpResponse.error()` creates a network-error response.
+
+Resolver information can include `request`, `params`, and `cookies`:
+
+- `request.url` is a string. Parse it with `new URL(request.url)` when URL components are needed.
+- Read a request body with Fetch request methods such as `await request.json()`.
+- Path parameters are available through `params`.
+- Cookies are available through `cookies`.
+
+## Node interception
+
+Import `setupServer` from `msw/node`. Start interception with `server.listen()`, and finish with `server.close()`. `server.resetHandlers()` restores the initial handlers after runtime handler changes and is useful between tests.
+
+The Node integration intercepts native HTTP/HTTPS traffic without stubbing `fetch` or Axios. The following is a complete standalone Node example; it uses an absolute URL so it can run directly without a framework or test runner:
+
+```ts pmcp-example
+import assert from 'node:assert/strict'
+import { http, HttpResponse } from 'msw'
+import { setupServer } from 'msw/node'
+
+const server = setupServer(
+  http.get('https://example.test/users/:id', ({ params, request }) => {
+    const url = new URL(request.url)
+    return HttpResponse.json(
+      { id: params.id, host: url.host },
+      { status: 202, statusText: 'Mocked' },
+    )
+  }),
+)
+
+server.listen()
+try {
+  const response = await fetch('https://example.test/users/abc-123')
+  assert.equal(response.status, 202)
+  assert.equal(response.statusText, 'Mocked')
+  assert.deepEqual(await response.json(), {
+    id: 'abc-123',
+    host: 'example.test',
+  })
+} finally {
+  server.close()
+}
+```
+
+Request bodies are read from `request`, not from a v1 `req` argument:
+
+```ts pmcp-example
+import assert from 'node:assert/strict'
+import { http, HttpResponse } from 'msw'
+import { setupServer } from 'msw/node'
+
+const server = setupServer(
+  http.post('https://example.test/user', async ({ request }) => {
+    const user = await request.json() as { firstName: string }
+    return HttpResponse.json({ ...user, accepted: true }, { status: 201 })
+  }),
+)
+
+server.listen()
+try {
+  const response = await fetch('https://example.test/user', {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ firstName: 'John' }),
+  })
+  assert.equal(response.status, 201)
+  assert.deepEqual(await response.json(), {
+    firstName: 'John',
+    accepted: true,
+  })
+} finally {
+  server.close()
+}
+```
+
+In a test runner, the documented lifecycle is `listen()` before tests, `resetHandlers()` after each test, and `close()` after all tests.
+
+## GraphQL handlers
+
+Import `graphql` and `HttpResponse` from `msw`. The documented methods include `graphql.query()`, `graphql.mutation()`, `graphql.link(url)`, and `graphql.operation()`. A query or mutation resolver receives values including `query` and `variables`.
+
+GraphQL subscriptions are not supported. A standalone Node example can exercise a query handler through the normal Node setup:
+
+```ts pmcp-example
+import assert from 'node:assert/strict'
+import { graphql, HttpResponse } from 'msw'
+import { setupServer } from 'msw/node'
+
+const server = setupServer(
+  graphql.query('GetUser', ({ variables }) => {
+    return HttpResponse.json({
+      data: { user: { name: variables.userId === '1' ? 'John' : 'Unknown' } },
+    })
+  }),
+)
+
+server.listen()
+try {
+  const response = await fetch('https://example.test/graphql', {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({
+      operationName: 'GetUser',
+      query: 'query GetUser($userId: ID!) { user { name } }',
+      variables: { userId: '1' },
+    }),
+  })
+  assert.equal(response.status, 200)
+  assert.deepEqual(await response.json(), {
+    data: { user: { name: 'John' } },
+  })
+} finally {
+  server.close()
+}
+```
+
+A mutation follows the same pattern, using `graphql.mutation('CreateUser', resolver)` and reading its input from `variables`.
+
+## Browser setup
+
+Browser interception uses the separate `msw/browser` entry point:
+
+```ts
+import { setupWorker } from 'msw/browser'
+
+const worker = setupWorker(/* http/graphql handlers */)
+await worker.start()
+```
+
+This requires a Service Worker and is therefore not a standalone `bun example.ts` environment. Do not import `setupWorker` from `msw`; that is the MSW 1.x shape.
+
+## Migration traps from MSW 1.x
+
+Do not carry these older forms into v2:
+
+- `rest.get(...)` becomes `http.get(...)`.
+- `import { setupWorker } from 'msw'` becomes `import { setupWorker } from 'msw/browser'`.
+- `(req, res, ctx) => ...` becomes a resolver such as `({ request, params, cookies }) => ...`.
+- `res(ctx.json(value))` becomes `HttpResponse.json(value)`.
+- `req.url` is now `request.url`, a string; use `new URL(request.url)` when necessary.
+- `req.params`, `req.cookies`, and `req.body` move to resolver properties and Fetch `Request` methods.
+- `req.passthrough()` becomes `passthrough()`.
+- `res.once()` becomes the response option `{ once: true }`.
+- `res.networkError()` becomes `HttpResponse.error()`.
+- `ctx.*` response utilities become `HttpResponse` APIs.
+- `ctx.fetch(req)` becomes `fetch(bypass(request))`.
+- `.printHandlers()` becomes `.listHandlers()`.
+
+## Not covered
+
+This skill does not cover Service Worker installation or browser build configuration, test-runner-specific setup, Jest environment configuration, Axios-specific examples, passthrough implementation details, handler inspection details, or GraphQL schema/client configuration. The research also does not document the exact signatures or behavior of every `HttpResponse` option, `graphql.link()`, `graphql.operation()`, or runtime handler mutation APIs.

package/plugins/negotiator-1/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "negotiator-1",
+  "version": "1.0.0",
+  "description": "Use negotiator 1.x to select preferred media types, languages, charsets, and encodings from request headers, including the 1.0.0 options-object form for preferred encoding order.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/negotiator-1/LICENSE

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/plugins/negotiator-1/NOTICE

@@ -0,0 +1,51 @@
+pmcp
+
+Copyright (c) 2026 modootoday. All rights reserved.
+
+Licensor: modootoday
+Licensed under the Elastic License 2.0; see LICENSE.
+
+The licensor is modootoday, the company, not any individual contributor. This
+file names the licensor because the Elastic License 2.0 defines that term rather
+than carrying a copyright line of its own; LICENSE is kept unmodified.
+
+What the licence permits, in short, without replacing the terms in LICENSE:
+
+  - Using this software inside your own company, on any scale.
+  - Embedding it in a product you sell, and modifying or forking it.
+  - Redistributing it, with these notices intact.
+  - Running it locally as an MCP server, which is what it is for. A host
+    process spawning it on your own machine is use, not a hosted service.
+
+What it does not permit:
+
+  - Offering this software to third parties as a hosted or managed service.
+    A remotely hosted MCP endpoint serving other people is the case this
+    forbids.
+  - Circumventing licence key functionality.
+  - Removing or obscuring these notices.
+
+The Elastic License 2.0 is source-available, not an OSI-approved open source
+licence. It grants a patent licence and ends that licence if you assert a patent
+claim against the software; see the Patents section of LICENSE.
+
+LICENSE governs. Where this summary and LICENSE differ, LICENSE is what applies.
+
+---
+
+This software depends on the following packages, which are distributed under
+their own terms and are not covered by the licence above.
+
+  @modelcontextprotocol/server   MIT   Copyright (c) Anthropic, PBC
+  @modelcontextprotocol/core     MIT   Copyright (c) Anthropic, PBC
+  zod                            MIT   Copyright (c) Colin McDonnell
+  semver                         ISC   See the dependency's LICENSE file.
+  smol-toml              BSD-3-Clause   Copyright (c) Squirrel Chat et al.
+  yaml                           ISC   Copyright Eemeli Aro
+
+Full licence texts and copyright notices ship with those packages. Their
+respective licence terms govern distribution of those dependencies.
+
+@huggingface/transformers is an optional peer dependency. It is never
+distributed with this package; a user who wants semantic ranking installs it
+themselves, under its own Apache-2.0 terms.

package/plugins/negotiator-1/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "negotiator-1", "version": "1.0.0" }

package/plugins/negotiator-1/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "negotiator-1",
+  "version": "1.0.0",
+  "description": "Use negotiator 1.x to select preferred media types, languages, charsets, and encodings from request headers, including the 1.0.0 options-object form for preferred encoding order.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/negotiator-1/skills/negotiator/SKILL.md

@@ -0,0 +1,180 @@
+---
+name: negotiator
+description: Use negotiator 1.x to select preferred media types, languages, charsets, and encodings from request headers, including the 1.0.0 options-object form for preferred encoding order.
+---
+
+Verified against negotiator@1.1.0 on 2026-09-08. 4 of 4 examples executed.
+
+# negotiator
+
+`^1.0.0` targets the 1.x API. At the documented 1.0.0 baseline, the package drops support for Node versions older than 18 and accepts an options object for preferred encoding order.
+
+## Loading and constructing
+
+The package exports the `Negotiator` constructor as the default CommonJS export and as `.Negotiator`:
+
+```js
+var Negotiator = require('negotiator')
+```
+
+Construct it with a request-shaped object containing `headers`. The package reads headers from that object; it does not obtain an HTTP request or headers itself.
+
+```js
+var negotiator = new Negotiator({
+  headers: {
+    accept: 'text/html'
+  }
+})
+```
+
+The constructor can also be called without `new`, but using `new` is the documented form.
+
+## Media-type negotiation
+
+Methods:
+
+- `mediaTypes()` returns the client’s preferred media types.
+- `mediaTypes(availableMediaTypes)` filters and orders a supplied list.
+- `mediaType(availableMediaTypes)` returns the single best match.
+- `mediaType()` is the corresponding single-result form without an available list.
+
+```ts pmcp-example
+import assert from 'node:assert/strict'
+import Negotiator from 'negotiator'
+
+const negotiator = new Negotiator({
+  headers: {
+    accept: 'text/html, application/json;q=0.8'
+  }
+})
+
+assert.deepEqual(negotiator.mediaTypes(), ['text/html', 'application/json'])
+assert.deepEqual(
+  negotiator.mediaTypes(['application/json', 'text/plain', 'text/html']),
+  ['text/html', 'application/json']
+)
+assert.equal(
+  negotiator.mediaType(['application/json', 'text/plain', 'text/html']),
+  'text/html'
+)
+assert.equal(negotiator.mediaType(), 'text/html')
+```
+
+## Language negotiation
+
+Methods:
+
+- `languages()` returns the preferred languages.
+- `languages(availableLanguages)` filters and orders a supplied list.
+- `language(availableLanguages)` returns the best available language.
+- `language()` is the corresponding single-result form without an available list.
+
+```ts pmcp-example
+import assert from 'node:assert/strict'
+import Negotiator from 'negotiator'
+
+const negotiator = new Negotiator({
+  headers: {
+    'accept-language': 'es, pt;q=0.8, en;q=0.7'
+  }
+})
+
+assert.deepEqual(negotiator.languages(), ['es', 'pt', 'en'])
+assert.deepEqual(
+  negotiator.languages(['en', 'es', 'fr']),
+  ['es', 'en']
+)
+assert.equal(negotiator.language(['en', 'es', 'fr']), 'es')
+assert.equal(negotiator.language(), 'es')
+```
+
+## Charset negotiation
+
+Methods:
+
+- `charsets()` returns preferred character sets.
+- `charsets(availableCharsets)` filters and orders a supplied list.
+- `charset(availableCharsets)` returns the best available character set.
+- `charset()` is the corresponding single-result form without an available list.
+
+```ts pmcp-example
+import assert from 'node:assert/strict'
+import Negotiator from 'negotiator'
+
+const negotiator = new Negotiator({
+  headers: {
+    'accept-charset': 'utf-8, iso-8859-1;q=0.5'
+  }
+})
+
+assert.deepEqual(negotiator.charsets(), ['utf-8', 'iso-8859-1'])
+assert.deepEqual(
+  negotiator.charsets(['iso-8859-1', 'utf-8']),
+  ['utf-8', 'iso-8859-1']
+)
+assert.equal(negotiator.charset(['iso-8859-1', 'utf-8']), 'utf-8')
+assert.equal(negotiator.charset(), 'utf-8')
+```
+
+## Encoding negotiation
+
+Methods:
+
+- `encodings()` returns preferred content encodings.
+- `encodings(availableEncodings)` filters and orders a supplied list.
+- `encoding(availableEncodings)` returns the best available encoding.
+- `encoding()` is the corresponding single-result form without an available list.
+- `encoding(availableEncodings, { preferred })` and `encodings(availableEncodings, { preferred })` use the supplied `preferred` array to prioritize encodings with the same quality.
+
+In 1.0.0, the preferred order is an options property, not a second positional array argument. The older 0.6.4 shape was `encoding(availableEncodings, preferred)` / `encodings(availableEncodings, preferred)`; do not carry that shape forward.
+
+```ts pmcp-example
+import assert from 'node:assert/strict'
+import Negotiator from 'negotiator'
+
+const negotiator = new Negotiator({
+  headers: {
+    'accept-encoding': 'gzip;q=1, br;q=1, identity;q=0.5'
+  }
+})
+
+assert.deepEqual(negotiator.encodings(), ['gzip', 'br', 'identity'])
+assert.deepEqual(
+  negotiator.encodings(['br', 'gzip', 'identity']),
+  ['gzip', 'br', 'identity']
+)
+assert.equal(negotiator.encoding(['br', 'gzip', 'identity']), 'gzip')
+assert.deepEqual(
+  negotiator.encodings(['br', 'gzip'], { preferred: ['br', 'gzip'] }),
+  ['br', 'gzip']
+)
+assert.equal(
+  negotiator.encoding(['br', 'gzip'], { preferred: ['br', 'gzip'] }),
+  'br'
+)
+```
+
+## Backward-compatible aliases
+
+The following aliases remain available:
+
+- `preferredCharset` → `charset`
+- `preferredCharsets` → `charsets`
+- `preferredEncoding` → `encoding`
+- `preferredEncodings` → `encodings`
+- `preferredLanguage` → `language`
+- `preferredLanguages` → `languages`
+- `preferredMediaType` → `mediaType`
+- `preferredMediaTypes` → `mediaTypes`
+
+Use the canonical names in new code; aliases are useful when maintaining code written against the older naming scheme.
+
+## What this skill does not cover
+
+This skill does not cover HTTP server integration, framework adapters, CLI usage, installation commands, detailed wildcard and quality-factor edge cases, missing-header behavior, or behavior outside the documented 1.x API. The package is exercised directly with a caller-supplied request object; the research does not document a runner, CLI, or build step.
+
+Sources:
+
+- https://github.com/jshttp/negotiator/tree/v1.0.0
+- https://raw.githubusercontent.com/jshttp/negotiator/v1.0.0/README.md
+- https://raw.githubusercontent.com/jshttp/negotiator/v1.0.0/HISTORY.md

package/plugins/npm-run-path-6/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "npm-run-path-6",
+  "version": "6.0.0",
+  "description": "Use npm-run-path ^6.0.0 to construct npm-style PATH values or environment objects for Node child processes.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/npm-run-path-6/LICENSE

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.