@oomol-lab/open-connector 1.6.0 → 1.6.2

package/src/providers/clickhelp/actions.js

@@ -36,6 +36,7 @@ const topicSchema = s.looseRequiredObject("A ClickHelp topic.", {
 });
 const listProjects = defineProviderAction(service, {
     name: "list_projects",
+    operationType: "read",
     description: "List ClickHelp projects and publications available to the connected user.",
     followUpActions: ["clickhelp.get_project"],
     inputSchema: s.object("Filters for listing ClickHelp projects and publications.", {
@@ -48,6 +49,7 @@ const listProjects = defineProviderAction(service, {
 });
 const getProject = defineProviderAction(service, {
     name: "get_project",
+    operationType: "read",
     description: "Get one ClickHelp project or publication by id.",
     followUpActions: ["clickhelp.list_topics"],
     inputSchema: s.requiredObject("The ClickHelp project lookup.", {
@@ -59,6 +61,7 @@ const getProject = defineProviderAction(service, {
 });
 const listTopics = defineProviderAction(service, {
     name: "list_topics",
+    operationType: "read",
     description: "List or search topics within one ClickHelp project or publication.",
     followUpActions: ["clickhelp.get_topic"],
     inputSchema: s.object("Filters for listing topics in a ClickHelp project or publication.", {
@@ -74,6 +77,7 @@ const listTopics = defineProviderAction(service, {
 });
 const getTopic = defineProviderAction(service, {
     name: "get_topic",
+    operationType: "read",
     description: "Get one ClickHelp topic, optionally compiling its content as HTML or Markdown.",
     inputSchema: s.object("The ClickHelp topic lookup.", {
         projectId: nonEmptyString("The project or publication id."),
@@ -86,6 +90,7 @@ const getTopic = defineProviderAction(service, {
 });
 const createTopic = defineProviderAction(service, {
     name: "create_topic",
+    operationType: "write",
     description: "Create a topic in a ClickHelp project using HTML body content and topic metadata.",
     followUpActions: ["clickhelp.get_topic"],
     inputSchema: s.object("The ClickHelp topic to create.", {
@@ -121,6 +126,7 @@ const createTopic = defineProviderAction(service, {
 });
 const updateTopic = defineProviderAction(service, {
     name: "update_topic",
+    operationType: "write",
     description: "Update selected content or metadata fields on a ClickHelp topic.",
     inputSchema: s.object("The ClickHelp topic fields to update.", {
         projectId: nonEmptyString("The project id."),
@@ -140,6 +146,7 @@ const updateTopic = defineProviderAction(service, {
 });
 const searchPortal = defineProviderAction(service, {
     name: "search_portal",
+    operationType: "read",
     description: "Search full text across ClickHelp projects and publications available to the user.",
     followUpActions: ["clickhelp.get_topic"],
     inputSchema: s.object("The ClickHelp portal search query.", {

package/src/providers/cochrane/actions.js

@@ -14,6 +14,7 @@ const translationSchema = s.looseObject("A published Cochrane review translation
 export const cochraneActions = [
     defineProviderAction(service, {
         name: "get_review_metadata",
+        operationType: "read",
         description: "Get JSON metadata for a Cochrane review.",
         inputSchema: reviewIdInputSchema,
         outputSchema: s.object("The Cochrane review metadata response.", {
@@ -22,6 +23,7 @@ export const cochraneActions = [
     }),
     defineProviderAction(service, {
         name: "list_review_versions",
+        operationType: "read",
         description: "List JSON metadata for all versions of a Cochrane review.",
         inputSchema: reviewIdInputSchema,
         outputSchema: s.object("The Cochrane review versions response.", {
@@ -30,6 +32,7 @@ export const cochraneActions = [
     }),
     defineProviderAction(service, {
         name: "get_review_roles",
+        operationType: "read",
         description: "Get the document roles associated with a Cochrane review.",
         inputSchema: reviewIdInputSchema,
         outputSchema: s.object("The Cochrane review roles response.", {
@@ -38,6 +41,7 @@ export const cochraneActions = [
     }),
     defineProviderAction(service, {
         name: "list_review_translations",
+        operationType: "read",
         description: "List published translations for a Cochrane review or one of its versions.",
         inputSchema: s.object("A Cochrane review and optional published version.", {
             reviewId: s.string("The Cochrane review ID or CD number.", { minLength: 1 }),

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

@@ -0,0 +1,34 @@
+import { optionalString } from "../../core/cast.js";
+import { isPrivateNetworkAccessAllowed } from "../../core/request.js";
+import { createProviderFetch, defineProviderExecutors, defineProviderProxy, ProviderRequestError, requireApiKeyCredential, } from "../provider-runtime.js";
+import { coolifyActionHandlers, createCoolifyContext, normalizeCoolifyApiBaseUrl, validateCoolifyCredential, } from "./runtime.js";
+const service = "coolify";
+export const executors = defineProviderExecutors({
+    service,
+    handlers: coolifyActionHandlers,
+    async createContext(context, fetcher) {
+        const credential = await requireApiKeyCredential(context, service);
+        return createCoolifyContext(credential.values, credential.apiKey, fetcher, context.signal);
+    },
+    allowPrivateNetwork: isPrivateNetworkAccessAllowed,
+});
+export const proxy = defineProviderProxy({
+    service,
+    baseUrl: async (context) => {
+        const credential = await requireApiKeyCredential(context, service);
+        const value = optionalString(credential.metadata.apiBaseUrl) ??
+            optionalString(credential.metadata.baseUrl) ??
+            optionalString(credential.values.baseUrl);
+        if (!value)
+            throw new ProviderRequestError(500, "coolify connection is missing baseUrl metadata");
+        return normalizeCoolifyApiBaseUrl(value);
+    },
+    auth: { type: "api_key_authorization", prefix: "Bearer " },
+    allowPrivateNetwork: isPrivateNetworkAccessAllowed,
+});
+export const credentialValidators = {
+    apiKey(input, { fetcher, signal }) {
+        const guardedFetcher = createProviderFetch({ fetch: fetcher, allowPrivateNetwork: isPrivateNetworkAccessAllowed });
+        return validateCoolifyCredential(input.values, input.apiKey, guardedFetcher, signal);
+    },
+};

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

@@ -0,0 +1,14 @@
+import type { CredentialValidationResult } from "../../core/types.ts";
+import type { ProviderActionHandlers } from "../provider-runtime.ts";
+export interface CoolifyContext {
+    apiKey: string;
+    apiBaseUrl: string;
+    fetcher: typeof fetch;
+    signal?: AbortSignal;
+}
+type CoolifyActionHandler = (input: Record<string, unknown>, context: CoolifyContext) => Promise<unknown>;
+export declare const coolifyActionHandlers: ProviderActionHandlers<"coolify", CoolifyActionHandler>;
+export declare function createCoolifyContext(values: Record<string, string>, apiKey: string, fetcher: typeof fetch, signal?: AbortSignal): CoolifyContext;
+export declare function validateCoolifyCredential(values: Record<string, string>, apiKey: string, fetcher: typeof fetch, signal?: AbortSignal): Promise<CredentialValidationResult>;
+export declare function normalizeCoolifyApiBaseUrl(value: unknown, allowPrivateNetwork?: boolean): string;
+export {};

package/src/providers/coolify/runtime.js

@@ -0,0 +1,86 @@
+import { optionalBoolean, optionalInteger, optionalString } from "../../core/cast.js";
+import { assertPublicHttpUrl, isPrivateNetworkAccessAllowed } from "../../core/request.js";
+import { arrayPayload, objectPayload, requestJson } from "../http-json-runtime.js";
+import { providerInputError, requiredInputString } from "../provider-runtime.js";
+export const coolifyActionHandlers = {
+    async list_applications(input, context) {
+        const payload = await coolifyRequest("/applications", context, { tag: optionalString(input.tag) });
+        return { applications: arrayPayload(payload, "Coolify applications") };
+    },
+    async get_application(input, context) {
+        const payload = await coolifyRequest(`/applications/${resourceUuid(input)}`, context);
+        return { application: objectPayload(payload, "Coolify application") };
+    },
+    async get_application_logs(input, context) {
+        return objectPayload(await coolifyRequest(`/applications/${resourceUuid(input)}/logs`, context, {
+            lines: optionalInteger(input.lines),
+            show_timestamps: optionalBoolean(input.showTimestamps),
+        }), "Coolify application logs");
+    },
+    start_application(input, context) {
+        return coolifyRequest(`/applications/${resourceUuid(input)}/start`, context, { force: optionalBoolean(input.force), instant_deploy: optionalBoolean(input.instantDeploy) }, "POST");
+    },
+    stop_application(input, context) {
+        return coolifyRequest(`/applications/${resourceUuid(input)}/stop`, context, { docker_cleanup: optionalBoolean(input.dockerCleanup) }, "POST");
+    },
+    restart_application(input, context) {
+        return coolifyRequest(`/applications/${resourceUuid(input)}/restart`, context, {}, "POST");
+    },
+    async list_deployments(_input, context) {
+        const payload = await coolifyRequest("/deployments", context);
+        return { deployments: arrayPayload(payload, "Coolify deployments") };
+    },
+    async get_deployment(input, context) {
+        const payload = await coolifyRequest(`/deployments/${resourceUuid(input)}`, context);
+        return { deployment: objectPayload(payload, "Coolify deployment") };
+    },
+    deploy_resource(input, context) {
+        return coolifyRequest("/deploy", context, { uuid: requiredInputString(input.uuid, "uuid"), force: optionalBoolean(input.force) }, "POST");
+    },
+};
+export function createCoolifyContext(values, apiKey, fetcher, signal) {
+    return { apiKey, apiBaseUrl: normalizeCoolifyApiBaseUrl(values.baseUrl), fetcher, signal };
+}
+export async function validateCoolifyCredential(values, apiKey, fetcher, signal) {
+    const context = createCoolifyContext(values, apiKey, fetcher, signal);
+    const team = objectPayload(await coolifyRequest("/team", context, {}, "GET", "validate"), "Coolify team");
+    const id = optionalInteger(team.id);
+    const name = optionalString(team.name);
+    const host = new URL(context.apiBaseUrl).host;
+    return {
+        profile: { accountId: id == null ? `coolify:${host}` : `coolify:${id}`, displayName: name ?? `Coolify ${host}` },
+        grantedScopes: [],
+        metadata: { apiBaseUrl: context.apiBaseUrl, teamId: id, teamName: name },
+    };
+}
+export function normalizeCoolifyApiBaseUrl(value, allowPrivateNetwork = isPrivateNetworkAccessAllowed()) {
+    const instanceUrl = requiredInputString(value, "baseUrl");
+    const url = assertPublicHttpUrl(instanceUrl, {
+        fieldName: "baseUrl",
+        createError: providerInputError,
+        allowPrivateNetwork,
+    });
+    if (url.username || url.password)
+        throw providerInputError("baseUrl must not include credentials");
+    url.hash = "";
+    url.search = "";
+    const path = url.pathname.replace(/\/+$/u, "");
+    url.pathname = path.endsWith("/api/v1") ? path : `${path}/api/v1`;
+    return url.toString().replace(/\/$/u, "");
+}
+async function coolifyRequest(path, context, query = {}, method = "GET", phase = "execute") {
+    return requestJson({
+        providerName: "Coolify",
+        baseUrl: context.apiBaseUrl,
+        path,
+        method,
+        query,
+        headers: { authorization: `Bearer ${context.apiKey}` },
+        fetcher: context.fetcher,
+        signal: context.signal,
+        phase,
+    });
+}
+function resourceUuid(input) {
+    return encodeURIComponent(requiredInputString(input.uuid, "uuid"));
+}

package/src/providers/coupontools/actions.js

@@ -4,6 +4,7 @@ const service = "coupontools";
 const rawObjectSchema = s.looseObject("The raw Coupontools API object.");
 const listCouponsAction = defineProviderAction(service, {
     name: "list_coupons",
+    operationType: "read",
     description: "List coupon campaigns available to the authenticated Coupontools account.",
     inputSchema: s.object("Optional filters for listing Coupontools coupon campaigns.", {
         only_active: s.boolean("Whether to return only active coupon campaigns."),
@@ -18,6 +19,7 @@ const listCouponsAction = defineProviderAction(service, {
 });
 const getCouponAction = defineProviderAction(service, {
     name: "get_coupon",
+    operationType: "read",
     description: "Get a Coupontools coupon campaign by ID.",
     inputSchema: s.object("The Coupontools coupon lookup input.", {
         campaign: s.nonEmptyString("The coupon campaign ID, such as cam_123456."),
@@ -30,6 +32,7 @@ const getCouponAction = defineProviderAction(service, {
 });
 const createSingleUseUrlAction = defineProviderAction(service, {
     name: "create_single_use_url",
+    operationType: "write",
     description: "Create a single-use URL for a Coupontools coupon campaign.",
     inputSchema: s.object("The recipient data and settings for a single-use coupon URL.", {
         campaign: s.nonEmptyString("The coupon campaign ID, such as cam_123456."),

package/src/providers/crustdata/actions.js

@@ -98,18 +98,21 @@ const autocompleteInputSchema = s.object({
 export const crustdataActions = [
     defineProviderAction(service, {
         name: "identify_companies",
+        operationType: "read",
         description: "Resolve companies from domains, profile URLs, names, or Crustdata company IDs and return ranked matches.",
         inputSchema: identifyLikeInputSchema,
         outputSchema: s.object({ results: s.array("The normalized identify results for each submitted identifier.", companyResultSchema) }, { required: ["results"], description: "The normalized Crustdata identify response." }),
     }),
     defineProviderAction(service, {
         name: "enrich_companies",
+        operationType: "read",
         description: "Enrich companies from one identifier family and optional field sections, returning ranked company matches with detailed profiles.",
         inputSchema: identifyLikeInputSchema,
         outputSchema: s.object({ results: s.array("The normalized enrich results for each submitted identifier.", companyResultSchema) }, { required: ["results"], description: "The normalized Crustdata enrich response." }),
     }),
     defineProviderAction(service, {
         name: "search_companies",
+        operationType: "read",
         description: "Search companies with Crustdata filters, optional field selection, sorting, and cursor pagination.",
         inputSchema: searchInputSchema,
         outputSchema: s.object({
@@ -123,6 +126,7 @@ export const crustdataActions = [
     }),
     defineProviderAction(service, {
         name: "autocomplete_companies",
+        operationType: "read",
         description: "Return exact field values to reuse in Crustdata company search filters.",
         inputSchema: autocompleteInputSchema,
         outputSchema: s.object({

package/src/providers/dadata_ru/actions.js

@@ -35,6 +35,7 @@ const addressSuggestionInputSchema = s.object("The input payload for a DaData ad
 export const dadataRuActions = [
     defineProviderAction(service, {
         name: "suggest_address",
+        operationType: "read",
         description: "Suggest Russian postal addresses from partial text using DaData's Suggestions API.",
         requiredScopes: [],
         inputSchema: addressSuggestionInputSchema,
@@ -42,6 +43,7 @@ export const dadataRuActions = [
     }),
     defineProviderAction(service, {
         name: "suggest_party",
+        operationType: "read",
         description: "Suggest Russian organizations and individual entrepreneurs from partial text using DaData's Suggestions API.",
         requiredScopes: [],
         inputSchema: commonSuggestionInputSchema,
@@ -49,6 +51,7 @@ export const dadataRuActions = [
     }),
     defineProviderAction(service, {
         name: "suggest_bank",
+        operationType: "read",
         description: "Suggest Russian banks from partial text using DaData's Suggestions API.",
         requiredScopes: [],
         inputSchema: commonSuggestionInputSchema,
@@ -56,6 +59,7 @@ export const dadataRuActions = [
     }),
     defineProviderAction(service, {
         name: "suggest_fio",
+        operationType: "read",
         description: "Suggest Russian full names from partial text using DaData's Suggestions API.",
         requiredScopes: [],
         inputSchema: commonSuggestionInputSchema,
@@ -63,6 +67,7 @@ export const dadataRuActions = [
     }),
     defineProviderAction(service, {
         name: "suggest_email",
+        operationType: "read",
         description: "Suggest email addresses from partial text using DaData's Suggestions API.",
         requiredScopes: [],
         inputSchema: commonSuggestionInputSchema,

package/src/providers/datacite/actions.js

@@ -68,6 +68,7 @@ const sortSchema = s.stringEnum("The ordering applied to matching DOI records.",
 export const dataciteActions = [
     defineProviderAction(service, {
         name: "get_doi",
+        operationType: "read",
         description: "Retrieve one DataCite DOI metadata record, including non-public states when the connected API key permits access.",
         inputSchema: s.object("Input parameters for retrieving one DataCite DOI record.", {
             doi: doiSchema,
@@ -80,6 +81,7 @@ export const dataciteActions = [
     }),
     defineProviderAction(service, {
         name: "list_dois",
+        operationType: "read",
         description: "Search, filter, sort, and page through DataCite DOI metadata records with public or authenticated access.",
         inputSchema: s.object("Input parameters for listing DataCite DOI records.", {
             query: s.nonEmptyString("An OpenSearch query string over DOI metadata fields, such as titles.title:climate."),

package/src/providers/descript/actions.js

@@ -21,6 +21,7 @@ const submitOutputSchema = s.looseObject("A newly submitted Descript job.", {
 export const descriptActions = [
     defineProviderAction(service, {
         name: "list_projects",
+        operationType: "read",
         description: "List projects accessible to the Drive associated with the Descript API token.",
         inputSchema: s.object("Filters and pagination for listing Descript projects.", {
             name: s.string("A case-insensitive substring to match against project names."),
@@ -70,6 +71,7 @@ export const descriptActions = [
     }),
     defineProviderAction(service, {
         name: "get_project",
+        operationType: "read",
         description: "Get a Descript project with its media, compositions, and published links.",
         inputSchema: s.requiredObject("The project to retrieve.", { projectId: idSchema("The project UUID.") }),
         outputSchema: s.requiredObject("A Descript project response.", {
@@ -78,6 +80,7 @@ export const descriptActions = [
     }),
     defineProviderAction(service, {
         name: "list_jobs",
+        operationType: "read",
         description: "List recent Descript jobs with optional project, type, time, and pagination filters.",
         inputSchema: s.object("Filters and pagination for listing Descript jobs.", {
             projectId: idSchema("Only include jobs for this project UUID."),
@@ -99,6 +102,7 @@ export const descriptActions = [
     }),
     defineProviderAction(service, {
         name: "get_job",
+        operationType: "read",
         description: "Get the current state and type-specific result of a Descript job.",
         inputSchema: s.requiredObject("The job to retrieve.", { jobId: idSchema("The job UUID.") }),
         outputSchema: s.requiredObject("The normalized state and raw Descript job.", {
@@ -108,6 +112,7 @@ export const descriptActions = [
     }),
     defineProviderAction(service, {
         name: "cancel_job",
+        operationType: "destructive",
         description: "Cancel a running Descript job.",
         inputSchema: s.requiredObject("The job to cancel.", { jobId: idSchema("The running job UUID.") }),
         outputSchema: s.requiredObject("Confirmation that Descript accepted the cancellation.", {
@@ -116,6 +121,7 @@ export const descriptActions = [
     }),
     defineProviderAction(service, {
         name: "list_agent_models",
+        operationType: "read",
         description: "List the current Descript Underlord models and stable aliases.",
         inputSchema: s.requiredObject("No input is required.", {}),
         outputSchema: s.requiredObject("The live Descript agent model catalog.", {
@@ -126,6 +132,7 @@ export const descriptActions = [
     }),
     defineProviderAction(service, {
         name: "prompt_agent",
+        operationType: "write",
         description: "Submit an asynchronous Underlord request to create or edit a Descript project.",
         followUpActions: ["descript.get_job"],
         inputSchema: s.object("An Underlord instruction targeting an existing project or a new project name.", {
@@ -148,6 +155,7 @@ export const descriptActions = [
     }),
     defineProviderAction(service, {
         name: "import_media",
+        operationType: "write",
         description: "Import URL-hosted media into a new or existing Descript project asynchronously.",
         followUpActions: ["descript.get_job"],
         inputSchema: s.object("A URL-based Descript media import request.", {
@@ -173,6 +181,7 @@ export const descriptActions = [
     }),
     defineProviderAction(service, {
         name: "publish_project",
+        operationType: "destructive",
         description: "Publish or republish a Descript composition and produce share and download URLs asynchronously.",
         followUpActions: ["descript.get_job"],
         inputSchema: s.object("A Descript composition publish request.", {

package/src/providers/dialmycalls/actions.js

@@ -83,6 +83,7 @@ const deleteEnvelopeSchema = (resource) => s.requiredObject(`A DialMyCalls ${res
 export const dialMyCallsActions = [
     defineProviderAction(service, {
         name: "get_account",
+        operationType: "read",
         description: "Get the current DialMyCalls account details and available credit balance.",
         inputSchema: s.requiredObject("This action does not require any input.", {}),
         outputSchema: s.requiredObject("The current DialMyCalls account response.", {
@@ -92,18 +93,21 @@ export const dialMyCallsActions = [
     }),
     defineProviderAction(service, {
         name: "create_contact",
+        operationType: "write",
         description: "Create a contact in the current DialMyCalls account.",
         inputSchema: s.object("The input payload for creating a DialMyCalls contact.", contactMutationFields),
         outputSchema: contactEnvelopeSchema,
     }),
     defineProviderAction(service, {
         name: "get_contact",
+        operationType: "read",
         description: "Get one DialMyCalls contact by identifier.",
         inputSchema: contactIdInputSchema,
         outputSchema: contactEnvelopeSchema,
     }),
     defineProviderAction(service, {
         name: "update_contact",
+        operationType: "write",
         description: "Update one DialMyCalls contact by identifier.",
         inputSchema: s.requiredObject("The input payload for updating a DialMyCalls contact.", {
             contact_id: uuidSchema("The unique DialMyCalls contact identifier."),
@@ -113,18 +117,21 @@ export const dialMyCallsActions = [
     }),
     defineProviderAction(service, {
         name: "delete_contact",
+        operationType: "destructive",
         description: "Delete one DialMyCalls contact by identifier.",
         inputSchema: contactIdInputSchema,
         outputSchema: deleteEnvelopeSchema("contact"),
     }),
     defineProviderAction(service, {
         name: "list_contacts",
+        operationType: "read",
         description: "List DialMyCalls contacts with a bounded records range.",
         inputSchema: paginationSchema("The input payload for listing DialMyCalls contacts."),
         outputSchema: contactsEnvelopeSchema,
     }),
     defineProviderAction(service, {
         name: "list_group_contacts",
+        operationType: "read",
         description: "List contacts assigned to one DialMyCalls group.",
         inputSchema: paginationSchema("The input payload for listing contacts in one DialMyCalls group.", {
             group_id: uuidSchema("The unique DialMyCalls group identifier."),
@@ -133,6 +140,7 @@ export const dialMyCallsActions = [
     }),
     defineProviderAction(service, {
         name: "create_group",
+        operationType: "write",
         description: "Create a contact group in the current DialMyCalls account.",
         inputSchema: s.requiredObject("The input payload for creating a DialMyCalls group.", {
             name: s.nonEmptyString("The contact group name."),
@@ -141,12 +149,14 @@ export const dialMyCallsActions = [
     }),
     defineProviderAction(service, {
         name: "get_group",
+        operationType: "read",
         description: "Get one DialMyCalls contact group by identifier.",
         inputSchema: groupIdInputSchema,
         outputSchema: groupEnvelopeSchema,
     }),
     defineProviderAction(service, {
         name: "update_group",
+        operationType: "write",
         description: "Update one DialMyCalls contact group by identifier.",
         inputSchema: s.requiredObject("The input payload for updating a DialMyCalls group.", {
             group_id: uuidSchema("The unique DialMyCalls group identifier."),
@@ -156,12 +166,14 @@ export const dialMyCallsActions = [
     }),
     defineProviderAction(service, {
         name: "delete_group",
+        operationType: "destructive",
         description: "Delete one DialMyCalls contact group by identifier.",
         inputSchema: groupIdInputSchema,
         outputSchema: deleteEnvelopeSchema("group"),
     }),
     defineProviderAction(service, {
         name: "list_groups",
+        operationType: "read",
         description: "List DialMyCalls contact groups with a bounded records range.",
         inputSchema: paginationSchema("The input payload for listing DialMyCalls groups."),
         outputSchema: groupsEnvelopeSchema,

package/src/providers/docsautomator/actions.js

@@ -89,6 +89,7 @@ const automationIdInputSchema = buildAutomationSelectorSchema("The automation se
 export const docsautomatorActions = [
     defineProviderAction(service, {
         name: "create_document",
+        operationType: "write",
         description: "Generate one DocsAutomator document synchronously and return the resulting file URLs plus signing metadata when available.",
         requiredScopes: [],
         inputSchema: createDocumentInputSchema,
@@ -98,6 +99,7 @@ export const docsautomatorActions = [
     }),
     defineProviderAction(service, {
         name: "create_document_async",
+        operationType: "write",
         description: "Queue one DocsAutomator document generation job and return the job handle for later polling.",
         requiredScopes: [],
         followUpActions: ["docsautomator.get_document_job"],
@@ -112,6 +114,7 @@ export const docsautomatorActions = [
     }),
     defineProviderAction(service, {
         name: "get_document_job",
+        operationType: "read",
         description: "Get the current status of a DocsAutomator async document generation job and return the finished document result when available.",
         requiredScopes: [],
         asyncLifecycle: {
@@ -128,6 +131,7 @@ export const docsautomatorActions = [
     }),
     defineProviderAction(service, {
         name: "get_queue_stats",
+        operationType: "read",
         description: "Return current DocsAutomator queue statistics for the connected workspace.",
         requiredScopes: [],
         inputSchema: s.object("The input payload for retrieving DocsAutomator queue statistics.", {}),
@@ -137,6 +141,7 @@ export const docsautomatorActions = [
     }),
     defineProviderAction(service, {
         name: "list_automations",
+        operationType: "read",
         description: "List DocsAutomator automations in the current workspace with the core fields needed for document generation setup.",
         requiredScopes: [],
         inputSchema: s.object("The input payload for listing DocsAutomator automations.", {}),
@@ -146,6 +151,7 @@ export const docsautomatorActions = [
     }),
     defineProviderAction(service, {
         name: "get_automation",
+        operationType: "read",
         description: "Get one DocsAutomator automation by automationId or docId and return its current generation-related settings.",
         requiredScopes: [],
         inputSchema: automationIdInputSchema,
@@ -155,6 +161,7 @@ export const docsautomatorActions = [
     }),
     defineProviderAction(service, {
         name: "list_template_placeholders",
+        operationType: "read",
         description: "List the placeholder groups extracted from a DocsAutomator Google Doc template for one automation.",
         requiredScopes: [],
         inputSchema: automationIdInputSchema,

package/src/providers/docsend_2_pdf/actions.js

@@ -11,6 +11,7 @@ const pdfOutputSchema = s.object("The converted PDF delivery metadata.", {
 export const docsend2PdfActions = [
     defineProviderAction(service, {
         name: "convert",
+        operationType: "read",
         description: "Convert a DocSend document URL to PDF and return JSON-safe download metadata.",
         requiredScopes: [],
         inputSchema: s.object("Input parameters for converting one DocSend document to PDF.", {

package/src/providers/docsumo/actions.js

@@ -95,6 +95,7 @@ const summaryDocumentTypeSchema = s.object("The document-type summary object ret
 export const docsumoActions = [
     defineProviderAction(service, {
         name: "get_account_info",
+        operationType: "read",
         description: "Get Docsumo account details, monthly document quota usage, and the currently enabled document types.",
         requiredScopes: [],
         inputSchema: s.object("No input parameters are required for retrieving account info.", {}),
@@ -109,6 +110,7 @@ export const docsumoActions = [
     }),
     defineProviderAction(service, {
         name: "upload_document_from_url",
+        operationType: "write",
         description: "Upload one public file URL to Docsumo for a chosen document type and return the queued document metadata.",
         requiredScopes: [],
         inputSchema: s.object("Input parameters for uploading one public file URL to Docsumo.", {
@@ -127,6 +129,7 @@ export const docsumoActions = [
     }),
     defineProviderAction(service, {
         name: "list_documents",
+        operationType: "read",
         description: "List Docsumo documents with optional folder, type, status, search, sorting, and created-date filters.",
         requiredScopes: [],
         inputSchema: s.object("Input parameters for listing Docsumo documents.", {
@@ -172,6 +175,7 @@ export const docsumoActions = [
     }),
     defineProviderAction(service, {
         name: "get_document_detail",
+        operationType: "read",
         description: "Get Docsumo document detail metadata for one document, including page information and preview assets.",
         requiredScopes: [],
         inputSchema: s.object("Input parameters for retrieving one Docsumo document detail record.", {
@@ -183,6 +187,7 @@ export const docsumoActions = [
     }),
     defineProviderAction(service, {
         name: "get_extracted_data",
+        operationType: "read",
         description: "Get the simplified extracted Docsumo data for one document and preserve the dynamic section and field structure.",
         requiredScopes: [],
         inputSchema: s.object("Input parameters for retrieving simplified Docsumo extracted data.", {
@@ -194,6 +199,7 @@ export const docsumoActions = [
     }),
     defineProviderAction(service, {
         name: "get_documents_summary",
+        operationType: "read",
         description: "Get the Docsumo documents summary grouped by document type, including disabled types and status counts.",
         requiredScopes: [],
         inputSchema: s.object("No input parameters are required for documents summary.", {}),

package/src/providers/document360/actions.js

@@ -136,6 +136,7 @@ const searchHitSchema = s.object("A normalized Document360 search hit.", {
 });
 const listWorkspacesAction = defineProviderAction(service, {
     name: "list_workspaces",
+    operationType: "read",
     description: "List Document360 workspaces, also called project versions, for the API token.",
     requiredScopes: [],
     inputSchema: s.object("The input payload for listing Document360 workspaces.", {}),
@@ -147,6 +148,7 @@ const listWorkspacesAction = defineProviderAction(service, {
 });
 const listWorkspaceArticlesAction = defineProviderAction(service, {
     name: "list_workspace_articles",
+    operationType: "read",
     description: "List articles in a Document360 workspace with optional language and pagination filters.",
     requiredScopes: [],
     inputSchema: s.object("The input payload for listing Document360 workspace articles.", {
@@ -165,6 +167,7 @@ const listWorkspaceArticlesAction = defineProviderAction(service, {
 });
 const getWorkspaceCategoriesAction = defineProviderAction(service, {
     name: "get_workspace_categories",
+    operationType: "read",
     description: "Get the Document360 category hierarchy for a workspace.",
     requiredScopes: [],
     inputSchema: s.object("The input payload for getting Document360 workspace categories.", {
@@ -184,6 +187,7 @@ const getWorkspaceCategoriesAction = defineProviderAction(service, {
 });
 const searchWorkspaceAction = defineProviderAction(service, {
     name: "search_workspace",
+    operationType: "read",
     description: "Search for a phrase inside a Document360 workspace.",
     requiredScopes: [],
     inputSchema: s.object("The input payload for searching inside a Document360 workspace.", {