@oomol-lab/open-connector 1.6.1 → 1.6.3

package/src/providers/paperless_ngx/actions-documents.js

@@ -297,6 +297,7 @@ const getTaskFollowUp = "paperless_ngx.get_task";
 export const paperlessNgxDocumentActions = [
     defineProviderAction(service, {
         name: "list_documents",
+        operationType: "read",
         description: "List or search documents visible to the connected user, 25 per page by default. Filters mirror the Paperless-ngx query parameters: id, title, archive serial number, dates, correspondent, document type, storage path, tags, owner, custom fields, MIME type and content lookups can be combined; anything not modelled goes into additional_filters. query, text, title_search and more_like_id run a search-index query instead, returning results with __search_hit__ ordered by relevance, and only one of them may be used per call. Only root documents are listed; file versions appear inside each document's versions array. Requires the view_document permission.",
         requiredScopes: [],
         inputSchema: listDocumentsInputSchema,
@@ -304,6 +305,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "get_document",
+        operationType: "read",
         description: "Get one document with its metadata, tags, custom fields, notes, file versions and duplicate_documents (other documents sharing the same checksum). content holds the extracted text of the latest version unless version selects another one. Requires the view_document permission and view access to the document.",
         requiredScopes: [],
         inputSchema: getDocumentInputSchema,
@@ -311,6 +313,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "update_document",
+        operationType: "write",
         description: "Partially update a document: title, content, correspondent, document type, storage path, tags, creation date, archive serial number, custom fields, inbox tag removal, owner and object permissions. Only the provided fields are sent (PATCH); tags and custom_fields replace the whole list. Changing owner or set_permissions requires being the owner or a superuser. The response carries the full permissions object. Requires the change_document permission and change access to the document.",
         requiredScopes: [],
         inputSchema: updateDocumentInputSchema,
@@ -318,6 +321,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "delete_document",
+        operationType: "destructive",
         description: "Move a document and all of its file versions to the trash. Trashed documents stay restorable until the configured trash delay (30 days by default) expires and are removed from the search index immediately. Requires the delete_document permission and delete access to the document.",
         requiredScopes: [],
         inputSchema: s.object("The document to delete.", { id: documentIdField }),
@@ -325,6 +329,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "get_document_root",
+        operationType: "read",
         description: "Resolve the root document of any document id, including ids of file versions and trashed documents. For a root document the answer is its own id. Requires view access to the root document.",
         requiredScopes: [],
         inputSchema: s.object("The document or version to resolve.", {
@@ -336,6 +341,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "get_document_metadata",
+        operationType: "read",
         description: "Get file-level metadata of a document: checksums, sizes, MIME type, media file names, whether an archived PDF exists, parser metadata (such as PDF info and XMP fields) of the original and archived files, and the detected content language. Reads the latest version unless version is given. Requires view access to the document.",
         requiredScopes: [],
         inputSchema: s.object("The document whose metadata to read.", { id: documentIdField, version: versionQueryInputField }, { optional: ["version"] }),
@@ -343,6 +349,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "get_document_suggestions",
+        operationType: "read",
         description: "Get correspondent, tag, document type, storage path and date suggestions for a document from the matching rules and the trained classifier. Results are cached until the document or classifier changes. Requires change access to the document (403 otherwise).",
         requiredScopes: [],
         inputSchema: s.object("The document to get suggestions for.", { id: documentIdField }),
@@ -350,6 +357,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "get_document_ai_suggestions",
+        operationType: "read",
         description: "Ask the configured language model for a title, tags, correspondent, document type, storage path and dates for a document. Existing objects the model picked are returned as ids, new names it proposed are returned separately. Requires AI to be enabled on the instance: otherwise Paperless-ngx answers 400 AI is required for this feature, an invalid AI configuration yields 400 and a model timeout yields 503. The call blocks while the model answers, and requires change access to the document.",
         requiredScopes: [],
         inputSchema: s.object("The document to get AI suggestions for.", { id: documentIdField }),
@@ -357,6 +365,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "download_document",
+        operationType: "read",
         description: "Download the file of a document and hand it back as a local transit file. By default the archived PDF is served when it exists, otherwise the original upload; original=true always serves the original. The preview endpoint of Paperless-ngx serves exactly the same bytes with an inline disposition, so it is not exposed as a separate action. Works for trashed documents and file versions. Requires view access to the document; files above 200 MiB are rejected.",
         requiredScopes: [],
         inputSchema: downloadDocumentInputSchema,
@@ -364,6 +373,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "get_document_thumbnail",
+        operationType: "read",
         description: "Download the WebP thumbnail of a document (or of one of its file versions) and hand it back as a local transit file. Requires view access to the document.",
         requiredScopes: [],
         inputSchema: s.object("The document whose thumbnail to download.", { id: documentIdField, version: versionQueryInputField }, { optional: ["version"] }),
@@ -371,6 +381,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "list_document_notes",
+        operationType: "read",
         description: "List the notes attached to a document, newest first, each with its author. Requires the view_note permission and view access to the document.",
         requiredScopes: [],
         inputSchema: s.object("The document whose notes to list.", { id: documentIdField }),
@@ -378,6 +389,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "add_document_note",
+        operationType: "write",
         description: "Add a note to a document on behalf of the connected user and return the complete note list. Also bumps the document's modified timestamp and re-indexes it. Requires the add_note permission and change access to the document.",
         requiredScopes: [],
         inputSchema: s.object("The note to add.", {
@@ -388,6 +400,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "delete_document_note",
+        operationType: "destructive",
         description: "Delete one note from a document and return the remaining notes. Requires the delete_note permission and change access to the document; a note id that does not belong to the document yields 404.",
         requiredScopes: [],
         inputSchema: s.object("The note to delete.", {
@@ -398,6 +411,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "list_document_share_links",
+        operationType: "read",
         description: "List the share links of a document that have not expired yet, newest first. Requires change access to the document (Paperless-ngx treats reading share links as a sharing operation).",
         requiredScopes: [],
         inputSchema: s.object("The document whose share links to list.", { id: documentIdField }),
@@ -407,6 +421,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "get_document_history",
+        operationType: "read",
         description: "Get the audit trail of a document: every logged create, update, delete and access entry for the document and its custom field values, newest first, with the changed fields and the acting user. Requires the audit log to be enabled on the instance (PAPERLESS_AUDIT_LOG_ENABLED, otherwise 400 Audit log is disabled), the auditlog.view_logentry permission, and the connected user must own the document, be a superuser, or the document must be unowned.",
         requiredScopes: [],
         inputSchema: s.object("The document whose history to read.", { id: documentIdField }),
@@ -416,6 +431,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "email_document",
+        operationType: "write",
         description: "Send one document as an email attachment through the mail server configured on the Paperless-ngx instance. The archived PDF is attached when it exists unless use_archive_version is false. Paperless-ngx routes this through its collection email endpoint with a single document id. Requires the view_document permission, view access to the document and a configured outgoing mail server (otherwise a 500 Error emailing documents).",
         requiredScopes: [],
         inputSchema: s.object("The document to email and the message to send.", { id: documentIdField, ...emailInputFields }, { optional: ["use_archive_version"] }),
@@ -423,6 +439,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "email_documents",
+        operationType: "write",
         description: "Send several documents as attachments of one email through the mail server configured on the Paperless-ngx instance. Archived PDFs are attached when they exist unless use_archive_version is false. Requires the view_document permission, view access to every document (403 otherwise) and a configured outgoing mail server (otherwise a 500 Error emailing documents).",
         requiredScopes: [],
         inputSchema: s.object("The documents to email and the message to send.", {
@@ -433,6 +450,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "update_document_version",
+        operationType: "write",
         description: "Upload a new file version for a document. The connector reads the supplied local transit file and posts it as multipart form field document; Paperless-ngx consumes it in the background as a new version of the root document, keeping title, tags and other metadata shared. Returns the Celery task id to poll with get_task. Requires the change_document permission and change access to the root document; unsupported file types are rejected with 400.",
         requiredScopes: [],
         asyncLifecycle: {
@@ -450,6 +468,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "delete_document_version",
+        operationType: "destructive",
         description: "Permanently delete one non-root file version of a document. The root (original) version cannot be deleted this way; delete the document instead (400 otherwise). Requires delete access to the root document.",
         requiredScopes: [],
         inputSchema: s.object("The version to delete.", {
@@ -462,6 +481,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "update_document_version_label",
+        operationType: "write",
         description: "Set or clear the label of one file version of a document, including the root version. Requires change access to the root document.",
         requiredScopes: [],
         inputSchema: s.object("The version and its new label.", {
@@ -473,6 +493,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "get_next_asn",
+        operationType: "read",
         description: "Get the next free archive serial number: the highest ASN currently in use plus one, or 1 when none is assigned. Trashed documents keep their ASN reserved.",
         requiredScopes: [],
         inputSchema: emptyInputSchema,
@@ -482,6 +503,7 @@ export const paperlessNgxDocumentActions = [
     }),
     defineProviderAction(service, {
         name: "upload_document",
+        operationType: "write",
         description: "Upload a file for consumption as a new document. The connector reads the supplied local transit file (at most 100 MiB) and posts it as multipart form field document together with the optional title, creation date, correspondent, document type, storage path, tags, archive serial number and custom field values. Paperless-ngx sniffs the file type from the bytes and rejects unsupported types with 400; consumption (OCR, matching, workflows) runs in the background, so the action returns the Celery task id to poll with get_task, whose result_data.document_id identifies the new document once it succeeded. The connected user becomes the owner. Requires the add_document permission.",
         requiredScopes: [],
         asyncLifecycle: {

package/src/providers/papertrail/executors.d.ts

@@ -0,0 +1,4 @@
+import type { CredentialValidators, ProviderExecutors, ProviderProxyExecutor } from "../../core/types.ts";
+export declare const executors: ProviderExecutors;
+export declare const proxy: ProviderProxyExecutor;
+export declare const credentialValidators: CredentialValidators;

package/src/providers/papertrail/executors.js

@@ -0,0 +1,15 @@
+import { defineApiKeyProviderExecutors, defineProviderProxy } from "../provider-runtime.js";
+import { papertrailActionHandlers, validatePapertrailCredential } from "./runtime.js";
+const service = "papertrail";
+export const executors = defineApiKeyProviderExecutors(service, papertrailActionHandlers);
+export const proxy = defineProviderProxy({
+    service,
+    baseUrl: "https://papertrailapp.com/api/v1/",
+    auth: { type: "api_key_header", name: "x-papertrail-token" },
+    skipDnsValidation: true,
+});
+export const credentialValidators = {
+    apiKey(input, { fetcher, signal }) {
+        return validatePapertrailCredential(input.apiKey, fetcher, signal);
+    },
+};

package/src/providers/papertrail/runtime.d.ts

@@ -0,0 +1,7 @@
+import type { CredentialValidationResult } from "../../core/types.ts";
+import type { ApiKeyProviderContext, ProviderActionHandlers, ProviderFetch } from "../provider-runtime.ts";
+export declare const papertrailApiBaseUrl = "https://papertrailapp.com/api/v1/";
+type PapertrailHandler = (input: Record<string, unknown>, context: ApiKeyProviderContext) => Promise<unknown>;
+export declare const papertrailActionHandlers: ProviderActionHandlers<"papertrail", PapertrailHandler>;
+export declare function validatePapertrailCredential(apiKey: string, fetcher: ProviderFetch, signal?: AbortSignal): Promise<CredentialValidationResult>;
+export {};

package/src/providers/papertrail/runtime.js

@@ -0,0 +1,167 @@
+import { compactObject, optionalBoolean, optionalInteger, optionalRecord, optionalString } from "../../core/cast.js";
+import { readProviderTextBody } from "../provider-runtime.js";
+import { providerUserAgent, ProviderRequestError, requiredResponseRecord, runProviderRequest, } from "../provider-runtime.js";
+export const papertrailApiBaseUrl = "https://papertrailapp.com/api/v1/";
+export const papertrailActionHandlers = {
+    async search_events(input, context) {
+        const payload = requiredResponseRecord(await requestPapertrail({
+            apiKey: context.apiKey,
+            path: "events/search.json",
+            query: compactObject({
+                q: optionalString(input.query),
+                system_id: optionalString(input.systemId),
+                group_id: optionalInteger(input.groupId),
+                min_id: optionalString(input.minId),
+                min_time: optionalInteger(input.minTime),
+                max_id: optionalString(input.maxId),
+                max_time: optionalInteger(input.maxTime),
+                limit: optionalInteger(input.limit),
+                tail: optionalBoolean(input.tail),
+            }),
+            fetcher: context.fetcher,
+            signal: context.signal,
+        }), "Papertrail event search response");
+        return {
+            events: requireArray(payload.events, "Papertrail events"),
+            minId: optionalString(payload.min_id) ?? null,
+            maxId: optionalString(payload.max_id) ?? null,
+            minTimeAt: optionalString(payload.min_time_at) ?? null,
+            maxTimeAt: optionalString(payload.max_time_at) ?? null,
+        };
+    },
+    async list_systems(_input, context) {
+        return {
+            systems: requireArray(await requestPapertrail({
+                apiKey: context.apiKey,
+                path: "systems.json",
+                fetcher: context.fetcher,
+                signal: context.signal,
+            }), "Papertrail systems response"),
+        };
+    },
+    async list_groups(_input, context) {
+        return {
+            groups: requireArray(await requestPapertrail({
+                apiKey: context.apiKey,
+                path: "groups.json",
+                fetcher: context.fetcher,
+                signal: context.signal,
+            }), "Papertrail groups response"),
+        };
+    },
+    async list_saved_searches(_input, context) {
+        return {
+            savedSearches: requireArray(await requestPapertrail({
+                apiKey: context.apiKey,
+                path: "searches.json",
+                fetcher: context.fetcher,
+                signal: context.signal,
+            }), "Papertrail saved-search response"),
+        };
+    },
+    async create_saved_search(input, context) {
+        return {
+            savedSearch: requiredResponseRecord(await requestPapertrail({
+                apiKey: context.apiKey,
+                path: "searches.json",
+                method: "POST",
+                body: { search: savedSearchBody(input) },
+                fetcher: context.fetcher,
+                signal: context.signal,
+            }), "Papertrail saved-search response"),
+        };
+    },
+    async update_saved_search(input, context) {
+        return {
+            savedSearch: requiredResponseRecord(await requestPapertrail({
+                apiKey: context.apiKey,
+                path: `searches/${optionalInteger(input.id)}.json`,
+                method: "PUT",
+                body: { search: savedSearchBody(input) },
+                fetcher: context.fetcher,
+                signal: context.signal,
+            }), "Papertrail saved-search response"),
+        };
+    },
+    async delete_saved_search(input, context) {
+        const payload = requiredResponseRecord(await requestPapertrail({
+            apiKey: context.apiKey,
+            path: `searches/${optionalInteger(input.id)}.json`,
+            method: "DELETE",
+            fetcher: context.fetcher,
+            signal: context.signal,
+        }), "Papertrail saved-search deletion response");
+        return { message: optionalString(payload.message) ?? "Saved search deleted" };
+    },
+};
+export async function validatePapertrailCredential(apiKey, fetcher, signal) {
+    const systems = requireArray(await requestPapertrail({ apiKey, path: "systems.json", phase: "validate", fetcher, signal }), "Papertrail systems response");
+    return {
+        profile: { accountId: "papertrail", displayName: "Papertrail API Token" },
+        grantedScopes: [],
+        metadata: {
+            apiBaseUrl: papertrailApiBaseUrl,
+            validationEndpoint: "/api/v1/systems.json",
+            systemCount: systems.length,
+        },
+    };
+}
+function savedSearchBody(input) {
+    return compactObject({
+        name: optionalString(input.name),
+        query: optionalString(input.query),
+        group_id: optionalInteger(input.groupId),
+    });
+}
+async function requestPapertrail(input) {
+    return runProviderRequest({ label: "Papertrail", signal: input.signal }, async (signal) => {
+        const url = new URL(input.path, papertrailApiBaseUrl);
+        for (const [key, value] of Object.entries(input.query ?? {}))
+            if (value !== undefined)
+                url.searchParams.set(key, String(value));
+        const response = await input.fetcher(url, {
+            method: input.method ?? "GET",
+            headers: {
+                accept: "application/json",
+                "content-type": "application/json",
+                "user-agent": providerUserAgent,
+                "x-papertrail-token": input.apiKey,
+            },
+            body: input.body === undefined ? undefined : JSON.stringify(input.body),
+            signal,
+        });
+        const payload = await readPapertrailPayload(response);
+        if (!response.ok)
+            throw mapPapertrailError(response.status, payload, input.phase ?? "execute");
+        return payload;
+    });
+}
+async function readPapertrailPayload(response) {
+    const text = await readProviderTextBody(response, "Papertrail response");
+    if (!text.trim())
+        return {};
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new ProviderRequestError(502, "Papertrail returned invalid JSON");
+    }
+}
+function mapPapertrailError(status, payload, phase) {
+    const record = optionalRecord(payload);
+    const message = optionalString(record?.message) ??
+        optionalString(record?.error) ??
+        `Papertrail request failed with status ${status}`;
+    if (status === 429)
+        return new ProviderRequestError(429, message, payload);
+    if (phase === "validate" && status === 401)
+        return new ProviderRequestError(400, message, payload);
+    if (status === 400 || status === 404 || status === 422)
+        return new ProviderRequestError(400, message, payload);
+    return new ProviderRequestError(status || 502, message, payload);
+}
+function requireArray(value, label) {
+    if (Array.isArray(value))
+        return value;
+    throw new ProviderRequestError(502, `${label} must be an array`);
+}

package/src/providers/patsnap_mcp/actions.js

@@ -8,6 +8,7 @@ import { patsnapServerNames } from "./servers.js";
 const patsnapCoreActions = [
     defineProviderAction("patsnap_mcp", {
         name: "transfer_data",
+        operationType: "read",
         description: "Retrieves Valuation Patent Transfer Data data so users can review the key information and continue with downstream analysis.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -20,6 +21,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "search_patents",
+        operationType: "read",
         description: "Searches Patent Search By Query based on input criteria and returns matching results for screening, comparison, and follow-up analysis.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -39,6 +41,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "reexamination_invalidation",
+        operationType: "read",
         description: "Retrieves Reexamination And Invalidation to assess status changes, patent stability, and potential legal risk.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -51,6 +54,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "pledge_data",
+        operationType: "read",
         description: "Retrieves Valuation Patent Pledge Data data so users can review the key information and continue with downstream analysis.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -63,6 +67,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "pdf",
+        operationType: "read",
         description: "Retrieves detailed Full-text PDF for verification, full-text review, and deeper analysis.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -75,6 +80,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "license_data",
+        operationType: "read",
         description: "Retrieves Valuation Patent License Data data so users can review the key information and continue with downstream analysis.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -87,6 +93,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "legal_data",
+        operationType: "read",
         description: "Retrieves detailed Legal Details for verification, full-text review, and deeper analysis.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -99,6 +106,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "get_patent_legal_status",
+        operationType: "read",
         description: "Retrieves Simple Legal Status to assess status changes, patent stability, and potential legal risk.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -111,6 +119,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "fulltext_image",
+        operationType: "read",
         description: "Retrieves detailed Full-text Images for verification, full-text review, and deeper analysis.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -125,6 +134,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "forward_citation",
+        operationType: "read",
         description: "Retrieves Valuation Patent Forward Citation data so users can review the key information and continue with downstream analysis.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -137,6 +147,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "family",
+        operationType: "read",
         description: "Retrieves Patent Family to review family relationships, jurisdictional coverage, and family breadth.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -149,6 +160,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "description_translated",
+        operationType: "read",
         description: "Retrieves detailed Translated Description for verification, full-text review, and deeper analysis.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -163,6 +175,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "description",
+        operationType: "read",
         description: "Retrieves detailed Description for verification, full-text review, and deeper analysis.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -176,6 +189,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "customs_data",
+        operationType: "read",
         description: "Retrieves Customs Recordation to assess status changes, patent stability, and potential legal risk.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -188,6 +202,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "claim_translated",
+        operationType: "read",
         description: "Retrieves detailed Translated Claims for verification, full-text review, and deeper analysis.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -202,6 +217,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "claims",
+        operationType: "read",
         description: "Retrieves detailed Claims for verification, full-text review, and deeper analysis.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -215,6 +231,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "bibliography",
+        operationType: "read",
         description: "Retrieves detailed Bibliography for verification, full-text review, and deeper analysis.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -227,6 +244,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "award_data",
+        operationType: "read",
         description: "Retrieves Patent Awards to review honors, awards, and external recognition for a company or patent.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -239,6 +257,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "abstract_translated",
+        operationType: "read",
         description: "Retrieves Patent Abstract Translated data so users can review the key information and continue with downstream analysis.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -253,6 +272,7 @@ const patsnapCoreActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "abstract_image",
+        operationType: "read",
         description: "Retrieves Valuation Patent Abstract Image data so users can review the key information and continue with downstream analysis.",
         inputSchema: {
             ...s.requiredObject("Patsnap core patent tool arguments.", {
@@ -275,6 +295,7 @@ export const patsnapMcpActions = [
     ...patsnapDesignActions,
     defineProviderAction("patsnap_mcp", {
         name: "list_tools",
+        operationType: "read",
         description: "Discover current tools and live input schemas for one Patsnap MCP service. Defaults to core_patents.",
         inputSchema: s.requiredObject("Select one Patsnap MCP service to inspect.", {
             server: s.optional(s.stringEnum("MCP service to inspect; defaults to core_patents.", patsnapServerNames)),

package/src/providers/patsnap_mcp/design-actions.js

@@ -30,6 +30,7 @@ const uploadInput = s.requiredObject("Patsnap MCP tool arguments.", {
 export const patsnapDesignActions = [
     defineProviderAction("patsnap_mcp", {
         name: "design_submit_workflow",
+        operationType: "write",
         description: "Submit FTO workflow task \u2014 triggers the full pipeline (lineart conversion \u2192 search \u2192 rerank \u2192 RRF fusion \u2192 feature comparison \u2192 report generation) in one shot. Returns a task_id for polling via design_get_task_status and fetching results via design_get_stage_result",
         inputSchema: submitInput,
         outputSchema: patsnapResultSchema,
@@ -37,6 +38,7 @@ export const patsnapDesignActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "design_get_task_status",
+        operationType: "read",
         description: "Query workflow task status \u2014 returns lightweight task overview and per-stage summaries (status/duration/retry count/error message) without large result_data, suitable for high-frequency polling",
         inputSchema: statusInput,
         outputSchema: patsnapResultSchema,
@@ -44,12 +46,14 @@ export const patsnapDesignActions = [
     }),
     defineProviderAction("patsnap_mcp", {
         name: "design_get_stage_result",
+        operationType: "read",
         description: "Get execution result of a specific stage \u2014 returns the full business data (result_data) of a stage, which may be large. To get final results, typically use stage='feature_comparison' or 'generate_report'",
         inputSchema: stageInput,
         outputSchema: patsnapResultSchema,
     }),
     defineProviderAction("patsnap_mcp", {
         name: "design_create_image_upload_url",
+        operationType: "write",
         description: "Returns a temporary PUT upload URL. Upload the image binary to this URL using HTTP PUT, then pass the returned image URL to design_submit_workflow. This tool only creates the upload URL and does not accept image binaries or large base64 payloads.",
         inputSchema: uploadInput,
         outputSchema: patsnapResultSchema,