@oomol-lab/open-connector 1.6.1 → 1.6.3

package/src/providers/excel/actions.js

@@ -81,6 +81,7 @@ function action(input) {
 export const excelActions = [
     action({
         name: "create_workbook",
+        operationType: "write",
         description: "Create a new .xlsx workbook file and optionally populate worksheets and data.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({
@@ -96,6 +97,7 @@ export const excelActions = [
     }),
     action({
         name: "search_files",
+        operationType: "read",
         description: "Search workbook files in the current OneDrive drive and return matching drive items.",
         requiredScopes: readScope,
         inputSchema: s.actionInput({
@@ -108,6 +110,7 @@ export const excelActions = [
     }),
     action({
         name: "list_drive_item_children",
+        operationType: "read",
         description: "List direct child drive items for a folder or the drive root.",
         requiredScopes: readScope,
         inputSchema: s.actionInput({ driveId: workbookReference.driveId, itemId: workbookReference.itemId, top, select }),
@@ -115,6 +118,7 @@ export const excelActions = [
     }),
     action({
         name: "create_session",
+        operationType: "write",
         description: "Create an Excel workbook session for subsequent workbook operations.",
         requiredScopes: readScope,
         inputSchema: s.actionInput({
@@ -128,6 +132,7 @@ export const excelActions = [
     }),
     action({
         name: "get_workbook",
+        operationType: "read",
         description: "Read workbook metadata and optionally expand related workbook resources.",
         requiredScopes: readScope,
         inputSchema: s.actionInput({ ...workbookReference, expand: s.stringArray("Optional relationships to expand on the workbook resource.") }, ["itemId"]),
@@ -140,6 +145,7 @@ export const excelActions = [
     }),
     action({
         name: "list_worksheets",
+        operationType: "read",
         description: "List worksheets in a workbook.",
         requiredScopes: readScope,
         inputSchema: s.object(workbookReference, {
@@ -151,6 +157,7 @@ export const excelActions = [
     }),
     action({
         name: "get_worksheet",
+        operationType: "read",
         description: "Read a single worksheet by worksheet name or worksheet ID.",
         requiredScopes: readScope,
         inputSchema: s.actionInput({ ...workbookReference, worksheetId }, ["itemId", "worksheetId"]),
@@ -158,6 +165,7 @@ export const excelActions = [
     }),
     action({
         name: "add_worksheet",
+        operationType: "write",
         description: "Add a new worksheet to a workbook.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({ ...workbookReference, name: s.nonEmptyString("Worksheet name to create.") }, [
@@ -167,6 +175,7 @@ export const excelActions = [
     }),
     action({
         name: "update_worksheet",
+        operationType: "write",
         description: "Update worksheet metadata such as the name, position, or visibility.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({
@@ -180,6 +189,7 @@ export const excelActions = [
     }),
     action({
         name: "delete_worksheet",
+        operationType: "destructive",
         description: "Delete one worksheet from a workbook.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({ ...workbookReference, worksheetId }, ["itemId", "worksheetId"]),
@@ -187,6 +197,7 @@ export const excelActions = [
     }),
     action({
         name: "get_range",
+        operationType: "read",
         description: "Read one worksheet range by A1-style address.",
         requiredScopes: readScope,
         inputSchema: s.actionInput({ ...workbookReference, worksheetId, address }, ["itemId", "worksheetId", "address"]),
@@ -194,6 +205,7 @@ export const excelActions = [
     }),
     action({
         name: "get_worksheet_used_range",
+        operationType: "read",
         description: "Read the used range for one worksheet.",
         requiredScopes: readScope,
         inputSchema: s.actionInput({
@@ -205,6 +217,7 @@ export const excelActions = [
     }),
     action({
         name: "update_range",
+        operationType: "destructive",
         description: "Update one worksheet range with values, formulas, formats, or visibility flags.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({
@@ -223,6 +236,7 @@ export const excelActions = [
     }),
     action({
         name: "clear_range",
+        operationType: "destructive",
         description: "Clear one worksheet range.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({
@@ -235,6 +249,7 @@ export const excelActions = [
     }),
     action({
         name: "insert_range",
+        operationType: "write",
         description: "Insert one worksheet range and shift existing cells to make space.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({
@@ -247,6 +262,7 @@ export const excelActions = [
     }),
     action({
         name: "merge_cells",
+        operationType: "write",
         description: "Merge cells inside one worksheet range.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({
@@ -259,6 +275,7 @@ export const excelActions = [
     }),
     action({
         name: "sort_range",
+        operationType: "destructive",
         description: "Apply a Microsoft Graph sort definition to one worksheet range.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({
@@ -275,6 +292,7 @@ export const excelActions = [
     }),
     action({
         name: "list_tables",
+        operationType: "read",
         description: "List workbook tables, optionally restricted to one worksheet.",
         requiredScopes: readScope,
         inputSchema: s.actionInput({ ...workbookReference, worksheetId }, ["itemId"]),
@@ -282,6 +300,7 @@ export const excelActions = [
     }),
     action({
         name: "add_table",
+        operationType: "write",
         description: "Create a new workbook table from an address range.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({
@@ -294,6 +313,7 @@ export const excelActions = [
     }),
     action({
         name: "update_table",
+        operationType: "write",
         description: "Update table metadata such as the name, style, or header flags.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({
@@ -308,6 +328,7 @@ export const excelActions = [
     }),
     action({
         name: "convert_table_to_range",
+        operationType: "destructive",
         description: "Convert a workbook table back into a plain worksheet range.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({ ...workbookReference, tableId }, ["itemId", "tableId"]),
@@ -315,6 +336,7 @@ export const excelActions = [
     }),
     action({
         name: "list_table_rows",
+        operationType: "read",
         description: "List rows for one workbook table.",
         requiredScopes: readScope,
         inputSchema: s.actionInput({ ...workbookReference, tableId }, ["itemId", "tableId"]),
@@ -322,6 +344,7 @@ export const excelActions = [
     }),
     action({
         name: "add_table_row",
+        operationType: "write",
         description: "Add one or more rows to a workbook table.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({
@@ -334,6 +357,7 @@ export const excelActions = [
     }),
     action({
         name: "delete_table_row",
+        operationType: "destructive",
         description: "Delete one row from a workbook table by row index.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({ ...workbookReference, tableId, rowIndex: s.nonNegativeInteger("Zero-based row index to delete.") }, ["itemId", "tableId", "rowIndex"]),
@@ -341,6 +365,7 @@ export const excelActions = [
     }),
     action({
         name: "list_table_columns",
+        operationType: "read",
         description: "List columns for one workbook table.",
         requiredScopes: readScope,
         inputSchema: s.actionInput({ ...workbookReference, tableId }, ["itemId", "tableId"]),
@@ -348,6 +373,7 @@ export const excelActions = [
     }),
     action({
         name: "get_table_column",
+        operationType: "read",
         description: "Read one workbook table column by column name or column ID.",
         requiredScopes: readScope,
         inputSchema: s.actionInput({ ...workbookReference, tableId, columnId }, ["itemId", "tableId", "columnId"]),
@@ -355,6 +381,7 @@ export const excelActions = [
     }),
     action({
         name: "add_table_column",
+        operationType: "write",
         description: "Add one column to a workbook table.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({
@@ -367,6 +394,7 @@ export const excelActions = [
     }),
     action({
         name: "delete_table_column",
+        operationType: "destructive",
         description: "Delete one column from a workbook table.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({ ...workbookReference, tableId, columnId }, ["itemId", "tableId", "columnId"]),
@@ -374,6 +402,7 @@ export const excelActions = [
     }),
     action({
         name: "apply_table_filter",
+        operationType: "write",
         description: "Apply a Microsoft Graph filter criteria object to one table column.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({
@@ -386,6 +415,7 @@ export const excelActions = [
     }),
     action({
         name: "clear_table_filter",
+        operationType: "destructive",
         description: "Clear the current Microsoft Graph filter on one table column.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({ ...workbookReference, tableId, columnId }, ["itemId", "tableId", "columnId"]),
@@ -393,6 +423,7 @@ export const excelActions = [
     }),
     action({
         name: "apply_table_sort",
+        operationType: "destructive",
         description: "Apply a Microsoft Graph sort definition to one workbook table.",
         requiredScopes: writeScope,
         inputSchema: s.actionInput({

package/src/providers/faktoora/actions.js

@@ -63,6 +63,7 @@ const projectWriteFields = {
 export const faktooraActions = [
     defineProviderAction(service, {
         name: "list_projects",
+        operationType: "read",
         description: "List Faktoora projects with pagination, filtering, and sorting.",
         inputSchema: s.object("Input for listing Faktoora projects.", {
             page: s.positiveInteger("The page number to return."),
@@ -83,6 +84,7 @@ export const faktooraActions = [
     }),
     defineProviderAction(service, {
         name: "create_project",
+        operationType: "write",
         description: "Create a Faktoora project.",
         inputSchema: s.object("Input for creating a Faktoora project.", projectWriteFields, {
             optional: ["description", "place", "eta", "estMinutes", "currency", "status", "customerId"],
@@ -91,6 +93,7 @@ export const faktooraActions = [
     }),
     defineProviderAction(service, {
         name: "get_project",
+        operationType: "read",
         description: "Retrieve a Faktoora project by UUID.",
         inputSchema: s.requiredObject("Input for retrieving a Faktoora project.", {
             projectId: projectIdSchema,
@@ -99,6 +102,7 @@ export const faktooraActions = [
     }),
     defineProviderAction(service, {
         name: "update_project",
+        operationType: "write",
         description: "Partially update a Faktoora project.",
         inputSchema: s.object("Input for updating a Faktoora project.", {
             projectId: projectIdSchema,
@@ -110,6 +114,7 @@ export const faktooraActions = [
     }),
     defineProviderAction(service, {
         name: "delete_project",
+        operationType: "destructive",
         description: "Permanently delete a Faktoora project without deleting its attached document.",
         inputSchema: s.requiredObject("Input for deleting a Faktoora project.", {
             projectId: projectIdSchema,
@@ -120,6 +125,7 @@ export const faktooraActions = [
     }),
     defineProviderAction(service, {
         name: "attach_project_document",
+        operationType: "write",
         description: "Attach one Faktoora document to an empty project.",
         inputSchema: s.requiredObject("Input for attaching a document to a Faktoora project.", {
             projectId: projectIdSchema,
@@ -135,6 +141,7 @@ export const faktooraActions = [
     }),
     defineProviderAction(service, {
         name: "detach_project_document",
+        operationType: "destructive",
         description: "Detach one Faktoora document from a project.",
         inputSchema: s.requiredObject("Input for detaching a document from a Faktoora project.", {
             projectId: projectIdSchema,

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

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

package/src/providers/fastmoss_mcp/actions.js

@@ -0,0 +1,43 @@
+import { s } from "../../core/json-schema.js";
+import { defineProviderAction } from "../../core/provider-definition.js";
+import officialTools from "./official-tools.json" with { type: "json" };
+const resultSchema = s.object("The FastMoss MCP tool result.", {
+    result: s.unknown("Structured MCP content when available; otherwise the complete MCP content envelope. Data availability and Credits depend on the connected FastMoss account."),
+}, { optional: [] });
+export const fastmossMcpActions = [
+    ...officialTools.map((tool) => defineProviderAction("fastmoss_mcp", {
+        name: tool.name,
+        operationType: "read",
+        description: tool.description,
+        requiredScopes: [],
+        inputSchema: tool.inputSchema,
+        outputSchema: resultSchema,
+    })),
+    defineProviderAction("fastmoss_mcp", {
+        name: "list_tools",
+        operationType: "read",
+        description: "Discover current FastMoss MCP tools, live argument schemas and behavior annotations for TikTok Shop product, creator, shop, advertising, agency and market research.",
+        requiredScopes: [],
+        inputSchema: s.object("No input is required.", {}, { optional: [] }),
+        outputSchema: s.object("The live FastMoss MCP tool catalog.", {
+            tools: s.array("Tools available to the connected FastMoss account.", s.object("One FastMoss MCP tool.", {
+                name: s.nonEmptyString("The exact tool name."),
+                description: s.string("The current official tool description."),
+                annotations: s.looseObject("Official MCP behavior annotations."),
+                inputSchema: s.looseObject("The current JSON Schema for tool arguments."),
+            }, { optional: ["description", "annotations"] })),
+        }, { optional: [] }),
+        followUpActions: ["fastmoss_mcp.call_tool"],
+    }),
+    defineProviderAction("fastmoss_mcp", {
+        name: "call_tool",
+        operationType: "destructive",
+        description: "Call any current FastMoss MCP tool after inspecting list_tools. Arguments must match the live schema. Calls may consume FastMoss Credits; inspect behavior annotations before invoking newly added tools.",
+        requiredScopes: [],
+        inputSchema: s.object("Call a live FastMoss MCP tool.", {
+            toolName: s.nonEmptyString("The exact tool name returned by list_tools."),
+            arguments: s.looseObject("Arguments matching the selected tool's live input schema."),
+        }, { optional: ["arguments"] }),
+        outputSchema: resultSchema,
+    }),
+];

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

@@ -0,0 +1,64 @@
+import { sha256Hex } from "../../core/aws-sigv4.js";
+import { optionalRecord } from "../../core/cast.js";
+import { listMcpTools, callMcpTool } from "../mcp-tools.js";
+import { defineApiKeyProviderExecutors, defineProviderProxy, mapProviderActionHandlers, requiredInputString, } from "../provider-runtime.js";
+import { fastmossMcpActions } from "./actions.js";
+const origin = "https://mcp.fastmoss.com";
+const endpoint = `${origin}/mcp`;
+const handlers = mapProviderActionHandlers("fastmoss_mcp", fastmossMcpActions, (_action, actionName) => async (input, context) => {
+    const connection = connectionInput(context.apiKey, context.fetcher, context.signal);
+    if (actionName === "list_tools")
+        return { tools: await listMcpTools(connection, { includeAnnotations: true }) };
+    return {
+        result: await callMcpTool({
+            ...connection,
+            toolName: actionName === "call_tool" ? requiredInputString(input.toolName, "toolName") : actionName,
+            arguments: actionName === "call_tool" ? (optionalRecord(input.arguments) ?? {}) : input,
+        }),
+    };
+});
+export const executors = defineApiKeyProviderExecutors("fastmoss_mcp", handlers, {
+    skipDnsValidation: true,
+});
+export const proxy = defineProviderProxy({
+    service: "fastmoss_mcp",
+    baseUrl: origin,
+    auth: { type: "api_key_query", name: "api_key" },
+    skipDnsValidation: true,
+    redirect: "error",
+    allowedEndpoint(value) {
+        const url = new URL(value, origin);
+        return (url.origin === origin &&
+            url.pathname === "/mcp" &&
+            url.hash === "" &&
+            [...url.searchParams.keys()].every((key) => key === "api_key"));
+    },
+    customizeRequest({ headers }) {
+        headers.set("accept", "application/json, text/event-stream");
+        headers.set("content-type", "application/json");
+    },
+});
+export const credentialValidators = {
+    async apiKey(input, { fetcher, signal }) {
+        const key = requiredInputString(input.apiKey, "MCP API Key");
+        const tools = await listMcpTools(connectionInput(key, fetcher, signal));
+        const hash = sha256Hex(key);
+        return {
+            profile: { accountId: `fastmoss-mcp:${hash}`, displayName: `FastMoss MCP · ${hash.slice(-6)}` },
+            metadata: { mcpEndpoint: endpoint, discoveredToolCount: tools.length },
+        };
+    },
+};
+function connectionInput(key, fetcher, signal) {
+    const url = new URL(endpoint);
+    url.searchParams.set("api_key", key.trim());
+    return {
+        endpoint: url.toString(),
+        service: "FastMoss",
+        fetcher,
+        signal,
+        redirect: "error",
+        terminateSession: true,
+        maxResponseBytes: 16 * 1024 * 1024,
+    };
+}