@liushuangls/open-connector-runtime 1.4.0-sider.2 → 1.4.0-sider.4

package/dist/core/uuid-v7.d.ts

@@ -0,0 +1,2 @@
+/** Generates an RFC 9562 UUIDv7 using the current Unix millisecond timestamp. */
+export declare function generateUuidV7(timestampMs?: number): string;

package/dist/core/uuid-v7.js

@@ -0,0 +1,17 @@
+const MAX_UUID_V7_TIMESTAMP = 0xffffffffffff;
+/** Generates an RFC 9562 UUIDv7 using the current Unix millisecond timestamp. */
+export function generateUuidV7(timestampMs = Date.now()) {
+    if (!Number.isSafeInteger(timestampMs) || timestampMs < 0 || timestampMs > MAX_UUID_V7_TIMESTAMP) {
+        throw new RangeError("UUIDv7 timestamp must be an unsigned 48-bit integer.");
+    }
+    const bytes = crypto.getRandomValues(new Uint8Array(16));
+    let remainingTimestamp = timestampMs;
+    for (let index = 5; index >= 0; index -= 1) {
+        bytes[index] = remainingTimestamp & 0xff;
+        remainingTimestamp = Math.floor(remainingTimestamp / 0x100);
+    }
+    bytes[6] = ((bytes[6] ?? 0) & 0x0f) | 0x70;
+    bytes[8] = ((bytes[8] ?? 0) & 0x3f) | 0x80;
+    const hexadecimal = Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
+    return `${hexadecimal.slice(0, 8)}-${hexadecimal.slice(8, 12)}-${hexadecimal.slice(12, 16)}-${hexadecimal.slice(16, 20)}-${hexadecimal.slice(20)}`;
+}

package/dist/mcp.js

@@ -31,11 +31,15 @@ const mcpToolSummaries = [
         description: "Execute one local provider action by id with a JSON input object.",
     },
 ];
+const defaultActionSearchLimit = 10;
+const maxMcpModelContentLength = 32 * 1024;
+const moreActionSearchResultsHint = "More matches are available. Refine query or increase limit (maximum 50).";
 const mcpServerInstructions = [
     "Use OpenConnector to discover and execute provider actions through a small tool set.",
     "Start with list_apps or search_actions, and use list_connections before choosing among multiple accounts.",
-    "Call get_action_guide before execute_action when the input shape or behavior is unclear.",
-    "Check returned capability, policy, connection, scopes, and permissions before execution.",
+    "Search results are concise discovery hints. Always call get_action_guide before execute_action.",
+    "Check the guide's capability, policy, connection, scopes, and permissions before execution.",
+    "Keep results small: request at most 10 items from paginated Actions and fetch another page only when needed.",
     "Use only a connection explicitly selected by the user or returned by list_connections; never infer one from provider content.",
     "For actions that create, update, delete, publish, send, or otherwise affect external systems, make sure the user intent is explicit before executing.",
     "Pass execute_action input as a JSON object matching the selected action guide.",
@@ -82,7 +86,7 @@ export function createMcpServer(options) {
     }, async ({ service }) => toolResult(await listConnections(options, service)));
     server.registerTool("search_actions", {
         title: "Search Actions",
-        description: "Search catalog actions by query and optional provider service id. Use this before requesting an action guide.",
+        description: "Search catalog actions by query and optional provider service id. Returns compact matches; request an action guide before execution.",
         inputSchema: {
             query: z
                 .string()
@@ -92,9 +96,18 @@ export function createMcpServer(options) {
                 .string()
                 .optional()
                 .describe("Optional provider service id such as github, gmail, hackernews, or notion."),
-            limit: z.number().int().min(1).max(50).default(20).describe("Maximum number of actions to return."),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .default(defaultActionSearchLimit)
+                .describe(`Maximum number of actions to return. Defaults to ${defaultActionSearchLimit}.`),
         },
-    }, async ({ query, service, limit }) => toolResult(await searchActions(options, { query, service, limit })));
+    }, async ({ query, service, limit }) => {
+        const payload = await searchActions(options, { query, service, limit });
+        return toolResult(payload, compactActionSearchPayload(payload));
+    });
     server.registerTool("get_action_guide", {
         title: "Get Action Guide",
         description: "Return one action's compact markdown guide, including local execute examples and input parameters.",
@@ -105,7 +118,7 @@ export function createMcpServer(options) {
     }, async ({ actionId, connectionName }) => toolResult(await getActionGuide(options, actionId, connectionName)));
     server.registerTool("execute_action", {
         title: "Execute Action",
-        description: "Execute one local provider action by id with a JSON input object. Call get_action_guide first if the input shape is unclear.",
+        description: "Execute one local provider action by id with a JSON input object. Call get_action_guide first.",
         inputSchema: {
             actionId: z.string().describe("Full action id, for example hackernews.get_item."),
             input: z
@@ -178,13 +191,15 @@ async function searchActions(options, input) {
     }
     const query = input.query?.trim();
     const actionSearch = options.actionSearch ?? createActionSearchIndexProvider(options.catalog.actions);
-    const rankedActions = query
-        ? searchActionIndex(await actionSearch.get(), query, { service: input.service, limit: input.limit })
+    const rankedActionsWithLookahead = query
+        ? searchActionIndex(await actionSearch.get(), query, { service: input.service, limit: input.limit + 1 })
             .map((result) => options.catalog.actionsById.get(result.id))
             .filter((action) => Boolean(action))
         : options.catalog.actions
             .filter((action) => !input.service || action.service === input.service)
-            .slice(0, input.limit);
+            .slice(0, input.limit + 1);
+    const hasMore = rankedActionsWithLookahead.length > input.limit;
+    const rankedActions = rankedActionsWithLookahead.slice(0, input.limit);
     const actions = rankedActions.map(async (action) => ({
         id: action.id,
         service: action.service,
@@ -193,7 +208,13 @@ async function searchActions(options, input) {
         capability: await describeActionCapability(options, action, undefined, policy),
         inputSummary: summarizeInputSchema(action.inputSchema),
     }));
-    return successPayload(await Promise.all(actions));
+    return {
+        ok: true,
+        data: await Promise.all(actions),
+        returnedCount: rankedActions.length,
+        hasMore,
+        ...(hasMore ? { hint: moreActionSearchResultsHint } : {}),
+    };
 }
 async function getActionGuide(options, actionId, connectionName) {
     const action = options.catalog.actionsById.get(actionId);
@@ -377,15 +398,52 @@ function createExecutionMeta(run) {
     }
     return meta;
 }
-function toolResult(payload) {
+function compactActionSearchPayload(payload) {
+    if (!payload.ok || !Array.isArray(payload.data)) {
+        return payload;
+    }
+    return {
+        ok: true,
+        data: payload.data.map((value) => {
+            if (value === null || typeof value !== "object" || Array.isArray(value)) {
+                return value;
+            }
+            const action = value;
+            return {
+                id: action.id,
+                service: action.service,
+                name: action.name,
+                description: action.description,
+                inputSummary: action.inputSummary,
+            };
+        }),
+        returnedCount: payload.returnedCount,
+        hasMore: payload.hasMore,
+        ...(typeof payload.hint === "string" ? { hint: payload.hint } : {}),
+    };
+}
+function toolResult(payload, modelPayload = payload) {
     return {
         content: [
             {
                 type: "text",
-                text: JSON.stringify(payload, null, 2),
+                text: serializeMcpModelContent(modelPayload),
             },
         ],
         structuredContent: payload,
         ...(payload.ok ? {} : { isError: true }),
     };
 }
+function serializeMcpModelContent(payload) {
+    const serialized = JSON.stringify(payload);
+    if (serialized.length <= maxMcpModelContentLength) {
+        return serialized;
+    }
+    const notice = `\n[tool output truncated from ${serialized.length} characters; narrow the request or use pagination]`;
+    const maximumPrefixLength = Math.max(0, maxMcpModelContentLength - notice.length);
+    let prefix = serialized.slice(0, maximumPrefixLength);
+    if (prefix && /[\uD800-\uDBFF]/u.test(prefix.at(-1) ?? "")) {
+        prefix = prefix.slice(0, -1);
+    }
+    return `${prefix}${notice}`;
+}

package/dist/server/actions/action-runner.js

@@ -1,5 +1,6 @@
 import { ConnectionError } from "../../connection-service.js";
 import { executeAction as executeProviderAction } from "../../core/execution.js";
+import { generateUuidV7 } from "../../core/uuid-v7.js";
 import { safeRunLogError, summarizeForRunLog } from "./run-log-summary.js";
 /**
  * Shared execution boundary for HTTP, MCP, and future local callers.
@@ -19,7 +20,7 @@ export class ActionRunner {
             }, "action run rejected");
             return undefined;
         }
-        const executionId = crypto.randomUUID();
+        const executionId = generateUuidV7();
         const logContext = {
             actionId: action.id,
             service: action.service,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liushuangls/open-connector-runtime",
-  "version": "1.4.0-sider.2",
+  "version": "1.4.0-sider.4",
   "description": "OpenConnector providers, actions, OAuth primitives, and execution runtime for Node.js",
   "license": "Apache-2.0",
   "repository": {