@modootoday/pmcp 0.13.0 → 0.14.0

package/plugins/pydantic-2/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/pydantic-2/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/pydantic-2/gemini-extension.json

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

package/plugins/pydantic-2/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "pydantic-2",
+  "version": "1.0.0",
+  "description": "Use Python Pydantic 2 to validate typed input, choose strictness deliberately, normalize fields and serialize validated models. Use when working with BaseModel or TypeAdapter, not Pydantic AI. This is a manually loaded public-library skill, without automatic dependency matching.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

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

@@ -0,0 +1,74 @@
+---
+name: pydantic
+description: Use Python Pydantic 2 to validate typed input, choose strictness deliberately, normalize fields and serialize validated models. Use when working with BaseModel or TypeAdapter, not Pydantic AI. This is a manually loaded public-library skill, without automatic dependency matching.
+compatibility: "Python 3.10+ examples; Pydantic 2; manual loading."
+metadata:
+  ecosystem: pypi
+  target-identity: pydantic
+  selected-version: "2.13.4"
+  loading: manual
+---
+
+# Pydantic 2
+
+Manual-loading pilot targeting `pydantic==2.13.4`. Selected version metadata is not execution evidence. Inspect the project's interpreter, lockfile, installed Pydantic major and existing model configuration first. Preserve the project's environment manager and validation policy.
+
+## Validate at the boundary
+
+Model external input with `BaseModel`; use `model_validate` for Python values and `model_validate_json` for JSON bytes/text. Decide whether coercion and extra fields are intentional before changing an existing model. Strictness is not an automatic global upgrade.
+
+```python
+from pydantic import BaseModel, ConfigDict, field_validator
+
+
+class Item(BaseModel):
+    model_config = ConfigDict(strict=True, extra="forbid")
+
+    title: str
+    quantity: int
+    note: str | None = None
+
+    @field_validator("title")
+    @classmethod
+    def normalize_title(cls, value: str) -> str:
+        normalized = value.strip()
+        if not normalized:
+            raise ValueError("Title must contain text")
+        return normalized
+
+
+item = Item.model_validate({"title": " first ", "quantity": 2})
+assert item.title == "first"
+assert Item.model_validate_json(item.model_dump_json()) == item
+```
+
+Catch `ValidationError` at the application boundary and inspect structured `errors()` locations/types. Do not catch every exception as a validation failure. Avoid returning rejected input values in public error messages when they may contain secrets.
+
+Test numeric titles, string quantities under strict mode, unknown fields and whitespace-only titles. Successful normalization and validation rejection are different outcomes. Do not use `model_construct` for untrusted input: it bypasses validation.
+
+## Serialize deliberately
+
+`model_dump()` returns Python data; `model_dump(mode="json")` returns JSON-compatible data, and `model_dump_json()` returns JSON text. Select exclude/include and alias policy explicitly. `model_json_schema()` describes the public schema; it does not prove every custom validator is represented in JSON Schema.
+
+Strict Python input and strict JSON input are not identical for every type. For example, `TypeAdapter(date).validate_python(date_string, strict=True)` rejects a string, while `validate_json` can accept a JSON date string. Test the boundary actually used by the application.
+
+The native fixture targets typed validation, title normalization, error locations/types, JSON round-trip, required/extra-field schema shape and the strict date boundary. It does not cover settings/secrets, every union/scalar, async application integration or Pydantic AI.
+
+## Load manually
+
+Copy this file into a chosen local collection at `manual-library-skills/skills/pydantic/SKILL.md`. Explicitly load the file through your AI runtime or register only that chosen collection with PMCP:
+
+```toml
+[catalog]
+packages = ["./manual-library-skills"]
+```
+
+Merge that entry into existing configuration rather than replacing other collections. PMCP's local skill discovery needs no login. This route does not inspect PyPI dependencies or use `pmcp available/install` automatic matching. A local collection folder is not a PyPI or npm target identity. Runtime-specific folder trust remains native.
+
+## Primary sources and provenance
+
+- [Pydantic strict validation](https://docs.pydantic.dev/latest/concepts/strict_mode/)
+- [Pydantic 2.13.4 package metadata](https://pypi.org/project/pydantic/2.13.4/)
+- [Pinned MIT license](https://github.com/pydantic/pydantic/blob/v2.13.4/LICENSE)
+
+These instructions are original public-library guidance. The official Pydantic AI skill is for another library and is not substituted for BaseModel validation guidance.

package/plugins/react-19/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "react-19",
+  "version": "19.0.0",
+  "description": "Manage state, effects and form actions while preserving component and rendering boundaries.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/react-19/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/react-19/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/react-19/gemini-extension.json

@@ -0,0 +1 @@
+{ "name": "react-19", "version": "19.0.0" }

package/plugins/react-19/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "react-19",
+  "version": "19.0.0",
+  "description": "Manage state, effects and form actions while preserving component and rendering boundaries.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/react-19/skills/react/SKILL.md

@@ -0,0 +1,150 @@
+---
+name: react
+description: Implement and debug React 19 components, state updates, effect cleanup, form actions, transitions and renderer boundaries. Use for React component behavior; select react-dom guidance for browser roots or hydration and the framework's documentation for server integration.
+---
+
+# React 19 component behavior
+
+Read the installed React and renderer versions before using version-specific APIs.
+Keep react and react-dom on matching versions. The verification fixture targets
+the existing React DOM line's 19.2.8 pair; APIs introduced in later minors need
+their own compatibility check.
+
+## State, identity and closures
+
+Keep rendering pure. Call hooks at component or custom-hook top level; React's
+use API has separate rules and is not a reason to call other hooks conditionally.
+State is a snapshot for a render. Use a functional update when the next value
+depends on the previous value, particularly in timers or multiple queued updates:
+
+```tsx
+import { useState } from "react";
+
+export function Counter() {
+  const [count, setCount] = useState(0);
+
+  function incrementTwice() {
+    setCount((previous) => previous + 1);
+    setCount((previous) => previous + 1);
+  }
+
+  return <button onClick={incrementTwice}>{count}</button>;
+}
+```
+
+Replace state objects rather than mutate them. Keys identify sibling instances;
+use stable data identifiers rather than positions when items can move. Changing a
+key intentionally resets that component's state. Derive values during render
+instead of copying props into state or effects unless independent state is needed.
+
+## Synchronize with external systems
+
+An effect connects the component to an external system. Include every reactive
+value used by the effect, and mirror setup with cleanup. Development StrictMode
+can run setup, cleanup and setup again; do not suppress that cycle with a ref to
+hide missing cleanup.
+
+```tsx
+import { useEffect } from "react";
+
+export function Connection({ endpoint }: { endpoint: string }) {
+  useEffect(() => {
+    const controller = new AbortController();
+    let active = true;
+
+    async function connect() {
+      try {
+        const response = await fetch(endpoint, { signal: controller.signal });
+        if (!response.ok) throw new Error(`Request failed: ${response.status}`);
+        const result = await response.text();
+        if (!active) return;
+        console.log(result);
+      } catch (error) {
+        if (controller.signal.aborted) return;
+        console.error(error);
+      }
+    }
+
+    void connect();
+
+    return () => {
+      active = false;
+      controller.abort();
+    };
+  }, [endpoint]);
+
+  return null;
+}
+```
+
+Use the application's query/cache layer when it already owns fetching and
+deduplication. An effect example does not replace cache, routing or server data
+loading. Use event handlers for user actions rather than an effect triggered by
+an artificial state flag.
+
+## Forms and nonurgent updates
+
+useActionState receives the previous state before the action arguments. Validate
+FormData at the trust boundary and render the returned state. useFormStatus reads
+the status of a parent form, so put the submit-status component inside that form.
+
+```tsx
+import { useActionState } from "react";
+import { useFormStatus } from "react-dom";
+
+function SubmitButton() {
+  const { pending } = useFormStatus();
+  return <button disabled={pending}>Save</button>;
+}
+
+export function NameForm() {
+  const [message, save] = useActionState(
+    async (_previous: string, data: FormData) => {
+      const value = data.get("name");
+      if (typeof value !== "string" || !value.trim()) return "Enter a name";
+      return `Saved ${value.trim()}`;
+    },
+    "",
+  );
+
+  return (
+    <form action={save}>
+      <input name="name" defaultValue="Ada" />
+      <SubmitButton />
+      <output>{message}</output>
+    </form>
+  );
+}
+```
+
+Function actions reset uncontrolled fields after successful submission. Return
+expected validation failures as state; use error boundaries for thrown errors.
+Authentication, persistence and Server Action transport remain application or
+framework responsibilities.
+
+Transitions mark updates that can yield while urgent interactions proceed. Keep
+controlled text-input state urgent. In React 19, state updates after an await may
+need another startTransition call; consult the installed-version documentation.
+Do not treat useTransition as cancellation or a general request-ordering solution.
+
+## Renderer and server boundaries
+
+Use react-dom/client for browser roots and React Native's renderer for native UI.
+Hooks do not run in a standalone element-construction script; exercise state and
+effects through a renderer. use can read a cached promise from a compatible
+framework or library, not a new promise created during every render. Server
+Components and "use server" require framework integration; do not add those
+directives to ordinary client modules to create a server endpoint.
+
+For changes to behavior, test a visible state update, cleanup on unmount and the
+relevant form/error path. The DOM fixture also checks hydration of matching server
+markup; it does not establish browser layout, accessibility or framework SSR.
+
+## Sources
+
+- [State as a snapshot](https://react.dev/learn/state-as-a-snapshot)
+- [Queued state updates](https://react.dev/learn/queueing-a-series-of-state-updates)
+- [Effects and cleanup](https://react.dev/reference/react/useEffect)
+- [React 19 release](https://react.dev/blog/2024/12/05/react-19)
+- [useActionState](https://react.dev/reference/react/useActionState)
+- [useTransition](https://react.dev/reference/react/useTransition)

package/plugins/react-dom-19/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "react-dom-19",
+  "version": "19.0.1",
+  "description": "Create and clean up roots, hydrate matching markup and verify form interaction.",
+  "author": { "name": "modootoday" },
+  "license": "Elastic-2.0",
+  "repository": "https://github.com/modootoday/pmcp",
+  "homepage": "https://pmcp.build/skills/"
+}

package/plugins/react-dom-19/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.