@oomol-lab/open-connector 1.6.0 → 1.6.2

package/src/providers/feishu_app_bot/actions.js

@@ -288,6 +288,7 @@ const downloadableFileSchema = s.requiredObject("A downloadable file uploaded to
 export const feishuAppBotActions = [
     defineProviderAction(service, {
         name: "get_app_info",
+        operationType: "read",
         description: "Get the Feishu custom app profile and configured scopes for this connection.",
         requiredScopes: [feishuAppBotScopes.applicationRead],
         providerPermissions: [feishuAppBotScopes.applicationRead],
@@ -298,6 +299,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "get_app_permissions",
+        operationType: "read",
         description: "Get the currently published Feishu app version, tenant scopes, and subscribed events.",
         requiredScopes: [feishuAppBotScopes.applicationVersionRead],
         providerPermissions: [feishuAppBotScopes.applicationVersionRead],
@@ -312,6 +314,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "upload_image",
+        operationType: "write",
         description: "Upload one public image URL to Feishu/Lark and return the image key for message sending.",
         requiredScopes: [feishuAppBotScopes.resource],
         providerPermissions: [feishuAppBotScopes.resource],
@@ -322,6 +325,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "download_image",
+        operationType: "read",
         description: "Download one Feishu/Lark image by image key and upload it to transit storage.",
         inputSchema: s.object("Input for downloading one Feishu image.", {
             imageKey: s.string("The Feishu image key to download.", { minLength: 1 }),
@@ -335,6 +339,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "upload_file",
+        operationType: "write",
         description: "Upload one public file URL to Feishu/Lark and return the file key for message sending.",
         requiredScopes: [feishuAppBotScopes.resource],
         providerPermissions: [feishuAppBotScopes.resource],
@@ -350,6 +355,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "download_file",
+        operationType: "read",
         description: "Download one Feishu/Lark file by file key and upload it to transit storage.",
         inputSchema: s.object("Input for downloading one Feishu file.", {
             fileKey: s.string("The Feishu file key to download.", { minLength: 1 }),
@@ -363,6 +369,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "send_message",
+        operationType: "write",
         description: "Send a Feishu/Lark app bot message to a user or chat.",
         requiredScopes: [feishuAppBotScopes.sendMessage],
         providerPermissions: [feishuAppBotScopes.sendMessage],
@@ -377,6 +384,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "reply_message",
+        operationType: "write",
         description: "Reply to an existing Feishu/Lark message as the app bot.",
         requiredScopes: [feishuAppBotScopes.sendMessage],
         providerPermissions: [feishuAppBotScopes.sendMessage],
@@ -391,6 +399,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "get_message",
+        operationType: "read",
         description: "Fetch one Feishu/Lark message by message_id.",
         requiredScopes: [feishuAppBotScopes.readMessage, feishuAppBotScopes.groupMessage],
         providerPermissions: [feishuAppBotScopes.readMessage, feishuAppBotScopes.groupMessage],
@@ -403,6 +412,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "list_messages",
+        operationType: "read",
         description: "List Feishu/Lark history messages from a chat or thread.",
         requiredScopes: [feishuAppBotScopes.readMessage, feishuAppBotScopes.groupMessage],
         providerPermissions: [feishuAppBotScopes.readMessage, feishuAppBotScopes.groupMessage],
@@ -423,6 +433,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "list_chats",
+        operationType: "read",
         description: "List chats that the Feishu/Lark app bot currently belongs to.",
         requiredScopes: [feishuAppBotScopes.chatRead],
         providerPermissions: [feishuAppBotScopes.chatRead],
@@ -436,6 +447,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "search_chats",
+        operationType: "read",
         description: "Search chats visible to the Feishu/Lark app bot by keyword.",
         requiredScopes: [feishuAppBotScopes.chatRead],
         providerPermissions: [feishuAppBotScopes.chatRead],
@@ -449,6 +461,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "get_chat",
+        operationType: "read",
         description: "Fetch one Feishu/Lark chat by chat_id.",
         requiredScopes: [feishuAppBotScopes.chatRead],
         providerPermissions: [feishuAppBotScopes.chatRead],
@@ -460,6 +473,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "list_chat_members",
+        operationType: "read",
         description: "List visible members in one Feishu/Lark chat.",
         requiredScopes: [feishuAppBotScopes.chatMembersRead],
         providerPermissions: [feishuAppBotScopes.chatMembersRead],
@@ -473,6 +487,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "recall_message",
+        operationType: "write",
         description: "Recall one Feishu/Lark message that the app bot sent.",
         requiredScopes: [feishuAppBotScopes.recallMessage],
         providerPermissions: [feishuAppBotScopes.recallMessage],
@@ -483,6 +498,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "edit_message",
+        operationType: "write",
         description: "Edit a Feishu/Lark text or post message sent by the app bot.",
         requiredScopes: [feishuAppBotScopes.updateMessage],
         providerPermissions: [feishuAppBotScopes.updateMessage],
@@ -495,6 +511,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "add_message_reaction",
+        operationType: "write",
         description: "Add one emoji reaction to a Feishu/Lark message.",
         requiredScopes: [feishuAppBotScopes.reactionWrite],
         providerPermissions: [feishuAppBotScopes.reactionWrite],
@@ -506,6 +523,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "list_message_reactions",
+        operationType: "read",
         description: "List emoji reactions on one Feishu/Lark message.",
         requiredScopes: [feishuAppBotScopes.reactionRead],
         providerPermissions: [feishuAppBotScopes.reactionRead],
@@ -520,6 +538,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "remove_message_reaction",
+        operationType: "destructive",
         description: "Remove one Feishu/Lark message reaction by reaction_id.",
         requiredScopes: [feishuAppBotScopes.reactionWrite],
         providerPermissions: [feishuAppBotScopes.reactionWrite],
@@ -531,6 +550,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "pin_message",
+        operationType: "write",
         description: "Pin one Feishu/Lark message inside its chat.",
         requiredScopes: [feishuAppBotScopes.pinWrite],
         providerPermissions: [feishuAppBotScopes.pinWrite],
@@ -541,6 +561,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "list_pins",
+        operationType: "read",
         description: "List pin records in one Feishu/Lark chat and time window.",
         requiredScopes: [feishuAppBotScopes.pinRead],
         providerPermissions: [feishuAppBotScopes.pinRead],
@@ -555,6 +576,7 @@ export const feishuAppBotActions = [
     }),
     defineProviderAction(service, {
         name: "remove_pin",
+        operationType: "destructive",
         description: "Remove the pin state from one Feishu/Lark message.",
         requiredScopes: [feishuAppBotScopes.pinWrite],
         providerPermissions: [feishuAppBotScopes.pinWrite],
@@ -587,7 +609,7 @@ export const feishuAppBotActions = [
     ...createFeishuSheetsActions(service),
     ...createFeishuSheetsAdvancedActions(service),
     ...tenantMailActions([...createFeishuMailActions(service), ...createFeishuMailAdvancedActions(service)]),
-    ...createFeishuOkrActions(service),
+    ...createFeishuOkrActions(service, "tenant"),
     ...createFeishuFileActions(service),
     ...createFeishuVcActions({
         service,

package/src/providers/finchina/actions.d.ts

@@ -0,0 +1,2 @@
+import type { ActionDefinition } from "../../core/types.ts";
+export declare const finchinaActions: readonly ActionDefinition[];

package/src/providers/finchina/actions.js

@@ -0,0 +1,86 @@
+import { s } from "../../core/json-schema.js";
+import { defineProviderAction } from "../../core/provider-definition.js";
+const resultSchema = s.object("The discovered tool or metadata result.", {
+    result: s.unknown("Decoded FinChina JSON, or the original MCP content when no JSON object is returned."),
+}, { optional: [] });
+const queryResultSchema = s.looseObject("FinChina query data and business status, including additional upstream fields.", {
+    data: s.unknown("Query summary and records. records.headInfo describes the columns; records.data contains positional row arrays. Nested array columns retain their property metadata."),
+    status: s.looseObject("Business status and diagnostics. Codes below 100 indicate success.", {
+        code: s.number("FinChina business status code, including success with parameter adjustments."),
+    }),
+});
+const argumentsSchema = s.looseObject("Arguments matching the current schema discovered from FinChina. Preserve upstream field names and pagination parameters.");
+const companyFields = {
+    companies: s.array("Company names or unified social credit codes, up to 100 companies.", s.nonEmptyString("One company name or unified social credit code."), { minItems: 1, maxItems: 100 }),
+    indicators: s.array("Financial or company indicators in Chinese or English; FinChina supports fuzzy matching.", s.nonEmptyString("One requested indicator."), { minItems: 1 }),
+    sort: s.array("Sort the query results by one or more fields.", s.object("One sort rule.", {
+        field: s.nonEmptyString("The indicator or field to sort by, such as 注册资本 or 营业总收入."),
+        order: s.stringEnum("Sort direction.", ["asc", "desc"]),
+    }, { optional: [] })),
+    additionalArguments: s.looseObject("Additional parameters from the discovered subtool schema. Must not repeat fields supplied through companies, indicators, date, or sort."),
+};
+export const finchinaActions = [
+    defineProviderAction("finchina", {
+        name: "list_tools",
+        operationType: "read",
+        requiredScopes: [],
+        description: "Discover FinChina financial and enterprise-risk navigation tools, the execution entry point, and metadata tools with their current input schemas.",
+        inputSchema: s.object("No input is required.", {}, { optional: [] }),
+        outputSchema: s.object("The current FinChina MCP tool catalog.", {
+            tools: s.array("Tools exposed by the connected FinChina account.", s.looseObject("A live MCP tool definition.", {
+                name: s.optional(s.string("The exact MCP tool name.")),
+                description: s.optional(s.string("The current upstream tool description.")),
+                inputSchema: s.optional(s.looseObject("The current JSON Schema for this tool's arguments.")),
+                annotations: s.optional(s.looseObject("Optional upstream behavior hints.")),
+            })),
+        }, { optional: [] }),
+    }),
+    defineProviderAction("finchina", {
+        name: "discover_tools",
+        operationType: "read",
+        requiredScopes: [],
+        description: "Call a FinChina query_* or screen_* navigation tool with no arguments to obtain subTools and their parameter schemas. This returns definitions, not business records. Use execute_tool to query a discovered subtool.",
+        inputSchema: s.object("The navigation tool to inspect after list_tools.", {
+            toolName: s.nonEmptyString("An exact query_* or screen_* tool name from list_tools."),
+        }, { optional: [] }),
+        outputSchema: resultSchema,
+    }),
+    defineProviderAction("finchina", {
+        name: "get_metadata",
+        operationType: "read",
+        requiredScopes: [],
+        description: "Query FinChina indicator definitions, enumerations, or parameter metadata through caihui_mcp_metadata. Inspect its current schema using list_tools before supplying arguments.",
+        inputSchema: s.object("Arguments for the FinChina metadata tool.", {
+            arguments: argumentsSchema,
+        }, { optional: [] }),
+        outputSchema: resultSchema,
+    }),
+    defineProviderAction("finchina", {
+        name: "execute_tool",
+        operationType: "read",
+        requiredScopes: [],
+        description: "Query a FinChina data subtool discovered with discover_tools. Pass its exact name and arguments. Queries consume account credits; this action executes one request without automatic pagination or business retries.",
+        inputSchema: s.object("A discovered FinChina data subtool and its arguments.", {
+            toolName: s.nonEmptyString("The exact subTools name returned by a navigation tool; not a top-level query_* or screen_* name."),
+            arguments: argumentsSchema,
+        }, { optional: [] }),
+        outputSchema: queryResultSchema,
+    }),
+    ...["get_company_basic_info", "get_company_financial_metrics"].map((name) => defineProviderAction("finchina", {
+        name,
+        operationType: "read",
+        requiredScopes: [],
+        description: name === "get_company_basic_info"
+            ? "Query company basic information and selected indicators through FinChina, such as registered capital. Consumes account credits and executes one query. Discover query_enterprise_profile for the current additional parameters."
+            : "Query company financial indicators through FinChina, such as revenue over the last three years. Consumes account credits and executes one query. Discover query_enterprise_financial_data for the current additional parameters.",
+        inputSchema: name === "get_company_financial_metrics"
+            ? s.object("Company indicator query parameters.", {
+                ...companyFields,
+                date: s.string("A reporting date or natural-language period, such as 近三年 or 2023年报."),
+            }, { optional: ["date", "sort", "additionalArguments"] })
+            : s.object("Company indicator query parameters.", companyFields, {
+                optional: ["sort", "additionalArguments"],
+            }),
+        outputSchema: queryResultSchema,
+    })),
+];

package/src/providers/finchina/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/finchina/executors.js

@@ -0,0 +1,129 @@
+import { sha256Hex } from "../../core/aws-sigv4.js";
+import { optionalRecord, optionalString, optionalNumber, looseArray, recordOrEmpty } from "../../core/cast.js";
+import { listMcpTools, callMcpTool } from "../mcp-tools.js";
+import { defineApiKeyProviderExecutors, defineProviderProxy, mapProviderActionHandlers, ProviderRequestError, requiredInputString, requiredResponseRecord, } from "../provider-runtime.js";
+import { finchinaActions } from "./actions.js";
+const endpoint = "https://mcp.finchina.com/finchina-data-mcp-server/mcp";
+const handlers = mapProviderActionHandlers("finchina", finchinaActions, (_action, actionName) => async (input, context) => {
+    const connection = mcpInput(context.apiKey, context.fetcher, context.signal);
+    if (actionName === "list_tools") {
+        return { tools: await listMcpTools(connection, { includeAnnotations: true }) };
+    }
+    let toolName = "execute_tool";
+    let toolArguments;
+    if (actionName === "discover_tools") {
+        toolName = requiredInputString(input.toolName, "toolName");
+        if (!toolName.startsWith("query_") && !toolName.startsWith("screen_")) {
+            throw new ProviderRequestError(400, "toolName must be a query_* or screen_* navigation tool from list_tools", undefined, "invalid_input");
+        }
+        toolArguments = {};
+    }
+    else if (actionName === "get_metadata") {
+        toolName = "caihui_mcp_metadata";
+        toolArguments = recordOrEmpty(input.arguments);
+    }
+    else if (actionName === "execute_tool") {
+        toolArguments = { tool_name: input.toolName, arguments: input.arguments };
+    }
+    else {
+        const query = { ...(optionalRecord(input.additionalArguments) ?? {}) };
+        if (input.sort !== undefined) {
+            if (Object.hasOwn(query, "sort_list"))
+                throw new ProviderRequestError(400, "additionalArguments must not repeat sort_list", undefined, "invalid_input");
+            query.sort_list = looseArray(input.sort).map((value) => {
+                const rule = recordOrEmpty(value);
+                return {
+                    sort_by: requiredInputString(rule.field, "sort.field"),
+                    order: requiredInputString(rule.order, "sort.order"),
+                };
+            });
+        }
+        for (const [source, target] of Object.entries({
+            companies: "target_company",
+            indicators: "indicator_name",
+            date: "date",
+        })) {
+            if (input[source] !== undefined) {
+                if (Object.hasOwn(query, target))
+                    throw new ProviderRequestError(400, `additionalArguments must not repeat ${target}`, undefined, "invalid_input");
+                query[target] = input[source];
+            }
+        }
+        toolArguments = { tool_name: actionName, arguments: query };
+    }
+    const result = await callMcpTool({
+        ...connection,
+        toolName,
+        arguments: toolArguments,
+        transformToolResult: decodeFinchinaResult,
+    });
+    if (toolName !== "execute_tool")
+        return { result };
+    const envelope = requiredResponseRecord(result, "FinChina query result");
+    const status = requiredResponseRecord(envelope.status, "FinChina query status");
+    if (optionalNumber(status.code) === undefined || !Object.hasOwn(envelope, "data")) {
+        throw new ProviderRequestError(502, "FinChina query result is missing data or status.code", undefined, "provider_error");
+    }
+    return envelope;
+});
+export const executors = defineApiKeyProviderExecutors("finchina", handlers, {
+    skipDnsValidation: true,
+});
+export const proxy = defineProviderProxy({
+    service: "finchina",
+    baseUrl: endpoint,
+    auth: { type: "api_key_header", name: "x-api-key" },
+    skipDnsValidation: true,
+    customizeRequest({ headers }) {
+        headers.set("accept", "application/json, text/event-stream");
+    },
+});
+export const credentialValidators = {
+    async apiKey(input, { fetcher, signal }) {
+        const apiKey = input.apiKey;
+        const tools = await listMcpTools(mcpInput(apiKey, fetcher, signal));
+        if (!tools.some((tool) => tool.name === "execute_tool")) {
+            throw new ProviderRequestError(502, "FinChina did not expose its execute_tool query entry point for this account", undefined, "provider_error");
+        }
+        return {
+            profile: { accountId: `finchina:${sha256Hex(apiKey).slice(0, 32)}`, displayName: "FinChina Account" },
+            metadata: { mcpEndpoint: endpoint, discoveredToolCount: tools.length },
+        };
+    },
+};
+function mcpInput(apiKey, fetcher, signal) {
+    return {
+        endpoint,
+        signal,
+        service: "FinChina",
+        headers: { "x-api-key": apiKey },
+        fetcher,
+        redirect: "error",
+        terminateSession: true,
+    };
+}
+function decodeFinchinaResult(result) {
+    if (!("content" in result))
+        return result;
+    let payload = optionalRecord(result.structuredContent);
+    if (payload === undefined && result.content[0]?.type === "text") {
+        try {
+            payload = optionalRecord(JSON.parse(result.content[0].text));
+        }
+        catch {
+            /* Preserve non-JSON MCP navigation content. */
+        }
+    }
+    const status = optionalRecord(payload?.status);
+    const code = optionalNumber(status?.code);
+    if (code !== undefined && code >= 100) {
+        const error = optionalRecord(status?.error);
+        const message = optionalString(error?.message) ??
+            optionalString(status?.error) ??
+            optionalString(status?.message) ??
+            "FinChina query failed";
+        const invalidInput = code === 100 || code === 300 || code === 400;
+        throw new ProviderRequestError(invalidInput ? 400 : code === 200 ? 403 : 502, message, { providerCode: code, providerStatus: status }, invalidInput ? "invalid_input" : "provider_error");
+    }
+    return { ...result, structuredContent: payload };
+}

package/src/providers/flomo/actions.js

@@ -66,6 +66,7 @@ const createMemoMcpOutputSchema = s.object("The memo created by the flomo MCP me
 const flomoMcpToolDefinitions = [
     {
         name: "memo_update",
+        operationType: "destructive",
         description: "Update an existing flomo memo through the flomo Max MCP server. The exact arguments are validated by flomo MCP.",
         inputSchema: s.object("Input for updating an existing flomo memo through flomo MCP.", {
             id: s.string("The ID of the memo to update."),
@@ -77,6 +78,7 @@ const flomoMcpToolDefinitions = [
     },
     {
         name: "memo_search",
+        operationType: "read",
         description: "Search flomo memos through the flomo Max MCP server by keywords, tags, time range, or semantic search options.",
         inputSchema: s.object("Input for searching flomo memos through flomo MCP.", {
             keywords: s.string("Keywords to search for in memo content."),
@@ -93,6 +95,7 @@ const flomoMcpToolDefinitions = [
     },
     {
         name: "memo_batch_get",
+        operationType: "read",
         description: "Fetch multiple flomo memos through the flomo Max MCP server in a single tool call.",
         inputSchema: s.object("Input for fetching flomo memos by ID through flomo MCP.", {
             id: s.string("One memo ID to fetch."),
@@ -104,6 +107,7 @@ const flomoMcpToolDefinitions = [
     },
     {
         name: "memo_recommended",
+        operationType: "read",
         description: "Find flomo memos related to a target memo through the flomo Max MCP server.",
         inputSchema: s.object("Input for finding memos related to a target flomo memo.", {
             id: s.string("The target memo ID."),
@@ -114,6 +118,7 @@ const flomoMcpToolDefinitions = [
     },
     {
         name: "tag_tree",
+        operationType: "read",
         description: "Fetch the flomo tag tree through the flomo Max MCP server.",
         inputSchema: s.object("Input for fetching a flomo tag tree.", {
             prefix: s.string("Only return tags under this prefix."),
@@ -123,6 +128,7 @@ const flomoMcpToolDefinitions = [
     },
     {
         name: "tag_search",
+        operationType: "read",
         description: "Search flomo tags through the flomo Max MCP server.",
         inputSchema: s.object("Input for searching flomo tags.", {
             keywords: s.string("Keywords to search for in tag names."),
@@ -134,6 +140,7 @@ const flomoMcpToolDefinitions = [
     },
     {
         name: "tag_rename",
+        operationType: "write",
         description: "Rename flomo tags through the flomo Max MCP server and update associated memos.",
         inputSchema: s.object("Input for renaming a flomo tag.", {
             old_tag: s.string("The existing tag name to rename."),
@@ -152,30 +159,35 @@ const flomoMcpToolDefinitions = [
     },
     {
         name: "memory_user",
+        operationType: "read",
         description: "Read the generated flomo memory user profile through the flomo Max MCP server.",
         inputSchema: s.object("Input for reading the flomo memory user profile.", {}),
         outputSchema: contentOutputSchema,
     },
     {
         name: "memory_context",
+        operationType: "read",
         description: "Read the generated flomo memory context through the flomo Max MCP server.",
         inputSchema: s.object("Input for reading the flomo memory context.", {}),
         outputSchema: contentOutputSchema,
     },
     {
         name: "get_daily_review",
+        operationType: "read",
         description: "Fetch flomo daily review content through the flomo Max MCP server.",
         inputSchema: s.object("Input for fetching the flomo daily review.", {}),
         outputSchema: mcpMemoListOutputSchema,
     },
     {
         name: "get_format_guide",
+        operationType: "read",
         description: "Fetch flomo memo formatting guidance through the flomo Max MCP server.",
         inputSchema: s.object("Input for fetching the flomo memo format guide.", {}),
         outputSchema: contentOutputSchema,
     },
     {
         name: "get_tag_guide",
+        operationType: "read",
         description: "Fetch flomo tag usage guidance through the flomo Max MCP server.",
         inputSchema: s.object("Input for fetching the flomo tag guide.", {}),
         outputSchema: contentOutputSchema,
@@ -184,6 +196,7 @@ const flomoMcpToolDefinitions = [
 export const flomoActions = [
     defineProviderAction(service, {
         name: "create_memo",
+        operationType: "write",
         description: "Create a flomo memo by sending markdown or plain text to the incoming webhook.",
         requiredScopes: [],
         inputSchema: createMemoInputSchema,
@@ -191,6 +204,7 @@ export const flomoActions = [
     }),
     ...flomoMcpToolDefinitions.map((tool) => defineProviderAction(service, {
         name: tool.name,
+        operationType: tool.operationType,
         description: tool.description,
         requiredScopes: [],
         inputSchema: tool.inputSchema,

package/src/providers/folk/actions.js

@@ -203,6 +203,7 @@ const updateCompanyInputSchema = {
 export const folkActions = [
     defineProviderAction(service, {
         name: "get_current_user",
+        operationType: "read",
         description: "Get the current Folk workspace user associated with the API key.",
         requiredScopes: [],
         inputSchema: s.object("The input payload for fetching the current Folk user.", {}),
@@ -212,6 +213,7 @@ export const folkActions = [
     }),
     defineProviderAction(service, {
         name: "list_users",
+        operationType: "read",
         description: "List workspace users from Folk with cursor pagination.",
         requiredScopes: [],
         inputSchema: s.object("The input payload for listing Folk workspace users.", { limit: limitField, cursor: cursorField }, { optional: ["limit", "cursor"] }),
@@ -222,6 +224,7 @@ export const folkActions = [
     }),
     defineProviderAction(service, {
         name: "get_user",
+        operationType: "read",
         description: "Get one Folk workspace user by user ID.",
         requiredScopes: [],
         inputSchema: s.object("The input payload for fetching one Folk user.", {
@@ -233,6 +236,7 @@ export const folkActions = [
     }),
     defineProviderAction(service, {
         name: "list_groups",
+        operationType: "read",
         description: "List Folk workspace groups with cursor pagination.",
         requiredScopes: [],
         inputSchema: s.object("The input payload for listing Folk groups.", { limit: limitField, cursor: cursorField }, { optional: ["limit", "cursor"] }),
@@ -243,6 +247,7 @@ export const folkActions = [
     }),
     defineProviderAction(service, {
         name: "list_group_custom_fields",
+        operationType: "read",
         description: "List Folk custom fields for one group and entity type.",
         requiredScopes: [],
         inputSchema: s.object("The input payload for listing Folk custom fields for one group.", {
@@ -258,6 +263,7 @@ export const folkActions = [
     }),
     defineProviderAction(service, {
         name: "list_people",
+        operationType: "read",
         description: "List Folk people with official cursor pagination and the documented nested filter syntax.",
         requiredScopes: [],
         inputSchema: listInputSchema("The input payload for listing Folk people.", true),
@@ -268,6 +274,7 @@ export const folkActions = [
     }),
     defineProviderAction(service, {
         name: "get_person",
+        operationType: "read",
         description: "Get one Folk person by person ID.",
         requiredScopes: [],
         inputSchema: s.object("The input payload for fetching one Folk person.", {
@@ -279,6 +286,7 @@ export const folkActions = [
     }),
     defineProviderAction(service, {
         name: "create_person",
+        operationType: "write",
         description: "Create one Folk person using the official people payload fields.",
         requiredScopes: [],
         inputSchema: personMutationInputSchema,
@@ -288,6 +296,7 @@ export const folkActions = [
     }),
     defineProviderAction(service, {
         name: "update_person",
+        operationType: "write",
         description: "Update one Folk person by person ID using the official people payload fields.",
         requiredScopes: [],
         inputSchema: updatePersonInputSchema,
@@ -297,6 +306,7 @@ export const folkActions = [
     }),
     defineProviderAction(service, {
         name: "delete_person",
+        operationType: "destructive",
         description: "Delete one Folk person by person ID.",
         requiredScopes: [],
         inputSchema: s.object("The input payload for deleting one Folk person.", {
@@ -308,6 +318,7 @@ export const folkActions = [
     }),
     defineProviderAction(service, {
         name: "list_companies",
+        operationType: "read",
         description: "List Folk companies with official cursor pagination and the documented nested filter syntax.",
         requiredScopes: [],
         inputSchema: listInputSchema("The input payload for listing Folk companies.", true),
@@ -318,6 +329,7 @@ export const folkActions = [
     }),
     defineProviderAction(service, {
         name: "get_company",
+        operationType: "read",
         description: "Get one Folk company by company ID.",
         requiredScopes: [],
         inputSchema: s.object("The input payload for fetching one Folk company.", {
@@ -329,6 +341,7 @@ export const folkActions = [
     }),
     defineProviderAction(service, {
         name: "create_company",
+        operationType: "write",
         description: "Create one Folk company using the official companies payload fields.",
         requiredScopes: [],
         inputSchema: companyMutationInputSchema,
@@ -338,6 +351,7 @@ export const folkActions = [
     }),
     defineProviderAction(service, {
         name: "update_company",
+        operationType: "write",
         description: "Update one Folk company by company ID using the official companies payload fields.",
         requiredScopes: [],
         inputSchema: updateCompanyInputSchema,
@@ -347,6 +361,7 @@ export const folkActions = [
     }),
     defineProviderAction(service, {
         name: "delete_company",
+        operationType: "destructive",
         description: "Delete one Folk company by company ID.",
         requiredScopes: [],
         inputSchema: s.object("The input payload for deleting one Folk company.", {