@apify/actors-mcp-server 0.6.8 → 0.7.1

package/dist/utils/mcp.js

@@ -8,9 +8,10 @@
  *                             it will be attached as `_toolStatus` so the server can read it
  *                             and strip it before sending the response to the MCP client.
  * @param options.structuredContent - Optional structured content of unknown type
+ * @param options._meta - Optional metadata for widget rendering (e.g., OpenAI widget metadata)
  */
 export function buildMCPResponse(options) {
-    const { texts, isError = false, toolStatus, structuredContent, } = options;
+    const { texts, isError = false, toolStatus, structuredContent, _meta, } = options;
     const response = {
         content: texts.map((text) => ({ type: 'text', text })),
         isError,
@@ -23,6 +24,10 @@ export function buildMCPResponse(options) {
     if (structuredContent !== undefined) {
         response.structuredContent = structuredContent;
     }
+    // Add metadata if provided (e.g., for widget rendering)
+    if (_meta !== undefined) {
+        response._meta = _meta;
+    }
     return response;
 }
 //# sourceMappingURL=mcp.js.map

package/dist/utils/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/utils/mcp.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,MAAM,UAAU,gBAAgB,CAAC,OAKhC;IACG,MAAM,EACF,KAAK,EACL,OAAO,GAAG,KAAK,EACf,UAAU,EACV,iBAAiB,GACpB,GAAG,OAAO,CAAC;IAEZ,MAAM,QAAQ,GAKV;QACA,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,OAAO;KACV,CAAC;IAEF,2EAA2E;IAC3E,IAAI,UAAU,EAAE,CAAC;QACb,QAAQ,CAAC,kBAAkB,GAAG,UAAU,CAAC;IAC7C,CAAC;IAED,qCAAqC;IACrC,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;QAClC,QAAQ,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IACnD,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC"}
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/utils/mcp.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAMhC;IACG,MAAM,EACF,KAAK,EACL,OAAO,GAAG,KAAK,EACf,UAAU,EACV,iBAAiB,EACjB,KAAK,GACR,GAAG,OAAO,CAAC;IAEZ,MAAM,QAAQ,GAMV;QACA,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,OAAO;KACV,CAAC;IAEF,2EAA2E;IAC3E,IAAI,UAAU,EAAE,CAAC;QACb,QAAQ,CAAC,kBAAkB,GAAG,UAAU,CAAC;IAC7C,CAAC;IAED,qCAAqC;IACrC,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;QAClC,QAAQ,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IACnD,CAAC;IAED,wDAAwD;IACxD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/dist/utils/tool-categories-helpers.d.ts

@@ -0,0 +1,10 @@
+import type { ToolCategory, ToolEntry } from '../types.js';
+/**
+ * Returns the tool objects for the given category names using toolCategories.
+ */
+export declare function getExpectedToolsByCategories(categories: ToolCategory[]): ToolEntry[];
+/**
+ * Returns the tool names for the given category names using getExpectedToolsByCategories.
+ */
+export declare function getExpectedToolNamesByCategories(categories: ToolCategory[]): string[];
+//# sourceMappingURL=tool-categories-helpers.d.ts.map

package/dist/utils/tool-categories-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-categories-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/tool-categories-helpers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE3D;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,SAAS,EAAE,CAGpF;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAErF"}

package/dist/utils/tool-categories-helpers.js

@@ -0,0 +1,19 @@
+/**
+ * Helper functions for working with tool categories.
+ * Separated from tools.ts to break circular dependency: tools/index.ts → utils/tools.ts → tools/categories.ts → tools/index.ts
+ */
+import { toolCategories } from '../tools/categories.js';
+/**
+ * Returns the tool objects for the given category names using toolCategories.
+ */
+export function getExpectedToolsByCategories(categories) {
+    return categories
+        .flatMap((category) => toolCategories[category] || []);
+}
+/**
+ * Returns the tool names for the given category names using getExpectedToolsByCategories.
+ */
+export function getExpectedToolNamesByCategories(categories) {
+    return getExpectedToolsByCategories(categories).map((tool) => tool.name);
+}
+//# sourceMappingURL=tool-categories-helpers.js.map

package/dist/utils/tool-categories-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-categories-helpers.js","sourceRoot":"","sources":["../../src/utils/tool-categories-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,UAA0B;IACnE,OAAO,UAAU;SACZ,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gCAAgC,CAAC,UAA0B;IACvE,OAAO,4BAA4B,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7E,CAAC"}

package/dist/utils/tools-loader.d.ts

@@ -3,14 +3,15 @@
  * This eliminates duplication between stdio.ts and processParamsGetTools.
  */
 import type { ApifyClient } from 'apify';
-import type { Input, ToolEntry } from '../types.js';
+import type { Input, ToolEntry, UiMode } from '../types.js';
 /**
  * Load tools based on the provided Input object.
  * This function is used by both the stdio.ts and the processParamsGetTools function.
  *
  * @param input The processed Input object
  * @param apifyClient The Apify client instance
+ * @param uiMode Optional UI mode.
  * @returns An array of tool entries
  */
-export declare function loadToolsFromInput(input: Input, apifyClient: ApifyClient): Promise<ToolEntry[]>;
+export declare function loadToolsFromInput(input: Input, apifyClient: ApifyClient, uiMode?: UiMode): Promise<ToolEntry[]>;
 //# sourceMappingURL=tools-loader.d.ts.map

package/dist/utils/tools-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools-loader.d.ts","sourceRoot":"","sources":["../../src/utils/tools-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AASzC,OAAO,KAAK,EAAE,KAAK,EAAkC,SAAS,EAAE,MAAM,aAAa,CAAC;AAepF;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACpC,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,GACzB,OAAO,CAAC,SAAS,EAAE,CAAC,CAkJtB"}
+{"version":3,"file":"tools-loader.d.ts","sourceRoot":"","sources":["../../src/utils/tools-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAUzC,OAAO,KAAK,EAAE,KAAK,EAAkC,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAe5F;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACpC,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,EACxB,MAAM,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,SAAS,EAAE,CAAC,CA2JtB"}

package/dist/utils/tools-loader.js

@@ -8,7 +8,8 @@ import { callActor } from '../tools/actor.js';
 import { getActorOutput } from '../tools/get-actor-output.js';
 import { addTool } from '../tools/helpers.js';
 import { getActorsAsTools, toolCategories, toolCategoriesEnabledByDefault } from '../tools/index.js';
-import { getExpectedToolsByCategories } from './tools.js';
+import { getActorRun } from '../tools/run.js';
+import { getExpectedToolsByCategories } from './tool-categories-helpers.js';
 // Lazily-computed cache of internal tools by name to avoid circular init issues.
 let INTERNAL_TOOL_BY_NAME_CACHE = null;
 function getInternalToolByNameMap() {
@@ -24,9 +25,10 @@ function getInternalToolByNameMap() {
  *
  * @param input The processed Input object
  * @param apifyClient The Apify client instance
+ * @param uiMode Optional UI mode.
  * @returns An array of tool entries
  */
-export async function loadToolsFromInput(input, apifyClient) {
+export async function loadToolsFromInput(input, apifyClient, uiMode) {
     // Helpers for readability
     const normalizeSelectors = (value) => {
         if (value === undefined)
@@ -123,6 +125,14 @@ export async function loadToolsFromInput(input, apifyClient) {
     if (hasCallActor || hasActorTools || hasAddActorTool) {
         result.push(getActorOutput);
     }
+    /**
+     * If call-actor tool is present or UI mode is enabled, automatically include get-actor-run
+     * to allow checking run status and retrieving results.
+     */
+    const hasGetActorRun = result.some((entry) => entry.name === HelperTools.ACTOR_RUNS_GET);
+    if (!hasGetActorRun && (hasCallActor || uiMode === 'openai')) {
+        result.push(getActorRun);
+    }
     // TEMP: for now we disable this swapping logic as the add-actor tool was misbehaving in some clients
     // Handle client capabilities logic for 'actors' category to swap call-actor for add-actor
     // if client supports dynamic tools.

package/dist/utils/tools-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools-loader.js","sourceRoot":"","sources":["../../src/utils/tools-loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tools-loader.js","sourceRoot":"","sources":["../../src/utils/tools-loader.ts"],"names":[],"mappings":"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"}

package/dist/utils/tools.d.ts

@@ -1,9 +1,13 @@
-import type { ToolBase, ToolCategory, ToolEntry } from '../types.js';
+import type { ActorsMcpServerOptions, ToolBase, ToolEntry } from '../types.js';
+type ToolPublicFieldOptions = {
+    uiMode?: ActorsMcpServerOptions['uiMode'];
+    filterOpenAiMeta?: boolean;
+};
 /**
  * Returns a public version of the tool containing only fields that should be exposed publicly.
  * Used for the tools list request.
  */
-export declare function getToolPublicFieldOnly(tool: ToolBase): {
+export declare function getToolPublicFieldOnly(tool: ToolBase, options?: ToolPublicFieldOptions): {
     name: string;
     title: string | undefined;
     description: string | undefined;
@@ -35,18 +39,12 @@ export declare function getToolPublicFieldOnly(tool: ToolBase): {
     execution: {
         taskSupport?: "optional" | "required" | "forbidden" | undefined;
     } | undefined;
+    _meta: Record<string, unknown> | undefined;
 };
-/**
- * Returns the tool objects for the given category names using toolCategories.
- */
-export declare function getExpectedToolsByCategories(categories: ToolCategory[]): ToolEntry[];
-/**
- * Returns the tool names for the given category names using getExpectedToolsByCategories.
- */
-export declare function getExpectedToolNamesByCategories(categories: ToolCategory[]): string[];
 /**
  * Creates a deep copy of a tool entry, preserving functions like ajvValidate and call
  * while cloning all other properties to avoid shared state mutations.
  */
 export declare function cloneToolEntry(toolEntry: ToolEntry): ToolEntry;
+export {};
 //# sourceMappingURL=tools.d.ts.map

package/dist/utils/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/utils/tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEjF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWpD;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,SAAS,EAAE,CAGpF;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAErF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAkB9D"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/utils/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAc,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE3F,KAAK,sBAAsB,GAAG;IAC1B,MAAM,CAAC,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC1C,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAkBF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE,sBAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiB1F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAkB9D"}

package/dist/utils/tools.js

@@ -1,9 +1,26 @@
-import { toolCategories } from '../tools/index.js';
+/**
+ * Strips OpenAI specific metadata from the tool metadata. U
+ * @param meta - The tool metadata.
+ * @returns The tool metadata with OpenAI specific metadata stripped.
+ */
+function stripOpenAiMeta(meta) {
+    if (!meta)
+        return meta;
+    const filteredEntries = Object.entries(meta)
+        .filter(([key]) => !key.startsWith('openai/'));
+    if (filteredEntries.length === 0)
+        return undefined;
+    return Object.fromEntries(filteredEntries);
+}
 /**
  * Returns a public version of the tool containing only fields that should be exposed publicly.
  * Used for the tools list request.
  */
-export function getToolPublicFieldOnly(tool) {
+export function getToolPublicFieldOnly(tool, options = {}) {
+    const { uiMode, filterOpenAiMeta = false } = options;
+    const meta = filterOpenAiMeta && uiMode !== 'openai'
+        ? stripOpenAiMeta(tool._meta)
+        : tool._meta;
     return {
         name: tool.name,
         title: tool.title,
@@ -13,21 +30,9 @@ export function getToolPublicFieldOnly(tool) {
         annotations: tool.annotations,
         icons: tool.icons,
         execution: tool.execution,
+        _meta: meta,
     };
 }
-/**
- * Returns the tool objects for the given category names using toolCategories.
- */
-export function getExpectedToolsByCategories(categories) {
-    return categories
-        .flatMap((category) => toolCategories[category] || []);
-}
-/**
- * Returns the tool names for the given category names using getExpectedToolsByCategories.
- */
-export function getExpectedToolNamesByCategories(categories) {
-    return getExpectedToolsByCategories(categories).map((tool) => tool.name);
-}
 /**
  * Creates a deep copy of a tool entry, preserving functions like ajvValidate and call
  * while cloning all other properties to avoid shared state mutations.

package/dist/utils/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/utils/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAc;IACjD,OAAO;QACH,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,SAAS,EAAE,IAAI,CAAC,SAAS;KAC5B,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,UAA0B;IACnE,OAAO,UAAU;SACZ,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gCAAgC,CAAC,UAA0B;IACvE,OAAO,4BAA4B,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAAoB;IAC/C,+BAA+B;IAC/B,MAAM,mBAAmB,GAAG,SAAS,CAAC,WAAW,CAAC;IAClD,MAAM,YAAY,GAAG,SAAS,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAEhF,oEAAoE;IACpE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC/D,IAAI,GAAG,KAAK,aAAa,IAAI,GAAG,KAAK,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9D,OAAO,KAAK,CAAC;IACjB,CAAC,CAAC,CAAc,CAAC;IAEjB,iCAAiC;IACjC,MAAM,CAAC,WAAW,GAAG,mBAAmB,CAAC;IACzC,IAAI,SAAS,CAAC,IAAI,KAAK,UAAU,IAAI,YAAY,EAAE,CAAC;QAC/C,MAAqB,CAAC,IAAI,GAAG,YAAY,CAAC;IAC/C,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/utils/tools.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,SAAS,eAAe,CAAC,IAAwB;IAC7C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;SACvC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IAEnD,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAEnD,OAAO,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAc,EAAE,UAAkC,EAAE;IACvF,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IACrD,MAAM,IAAI,GAAG,gBAAgB,IAAI,MAAM,KAAK,QAAQ;QAChD,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;QAC7B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IAEjB,OAAO;QACH,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,KAAK,EAAE,IAAI;KACd,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAAoB;IAC/C,+BAA+B;IAC/B,MAAM,mBAAmB,GAAG,SAAS,CAAC,WAAW,CAAC;IAClD,MAAM,YAAY,GAAG,SAAS,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAEhF,oEAAoE;IACpE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC/D,IAAI,GAAG,KAAK,aAAa,IAAI,GAAG,KAAK,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9D,OAAO,KAAK,CAAC;IACjB,CAAC,CAAC,CAAc,CAAC;IAEjB,iCAAiC;IACjC,MAAM,CAAC,WAAW,GAAG,mBAAmB,CAAC;IACzC,IAAI,SAAS,CAAC,IAAI,KAAK,UAAU,IAAI,YAAY,EAAE,CAAC;QAC/C,MAAqB,CAAC,IAAI,GAAG,YAAY,CAAC;IAC/C,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/utils/widgets.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Widget registry for MCP server UI widgets
+ *
+ * This module manages widget configuration and validates that widget files exist
+ * at runtime.
+ */
+export declare const WIDGET_URIS: {
+    readonly SEARCH_ACTORS: "ui://widget/search-actors.html";
+    readonly ACTOR_RUN: "ui://widget/actor-run.html";
+};
+export type WidgetConfig = {
+    uri: string;
+    name: string;
+    description: string;
+    jsFilename: string;
+    title: string;
+    meta: {
+        'openai/outputTemplate': string;
+        'openai/toolInvocation/invoking'?: string;
+        'openai/toolInvocation/invoked'?: string;
+        'openai/widgetAccessible': boolean;
+        'openai/resultCanProduceWidget': boolean;
+        'openai/widgetDomain': string;
+        'openai/widgetCSP': {
+            readonly connect_domains: readonly string[];
+            readonly resource_domains: readonly string[];
+        };
+    };
+};
+/**
+ * Widget registry configuration
+ * Maps widget URIs to their configuration
+ */
+export declare const WIDGET_REGISTRY: Record<string, WidgetConfig>;
+export type AvailableWidget = WidgetConfig & {
+    jsPath: string;
+    exists: boolean;
+};
+/**
+ * Resolves available widgets by checking if their files exist on the filesystem.
+ *
+ * @param baseDir - Base directory where the server code is located
+ * @returns Map of widget URIs to their resolved state
+ */
+export declare function resolveAvailableWidgets(baseDir: string): Promise<Map<string, AvailableWidget>>;
+/**
+ * Get widget configuration by URI
+ *
+ * @param uri - Widget URI
+ * @returns Widget configuration or undefined if not found
+ */
+export declare function getWidgetConfig(uri: string): WidgetConfig | undefined;
+//# sourceMappingURL=widgets.d.ts.map

package/dist/utils/widgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgets.d.ts","sourceRoot":"","sources":["../../src/utils/widgets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,eAAO,MAAM,WAAW;;;CAGd,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE;QACJ,uBAAuB,EAAE,MAAM,CAAC;QAChC,gCAAgC,CAAC,EAAE,MAAM,CAAC;QAC1C,+BAA+B,CAAC,EAAE,MAAM,CAAC;QACzC,yBAAyB,EAAE,OAAO,CAAC;QACnC,+BAA+B,EAAE,OAAO,CAAC;QACzC,qBAAqB,EAAE,MAAM,CAAC;QAC9B,kBAAkB,EAAE;YAClB,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;YAC5C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;SAC9C,CAAC;KACH,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA2BxD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAmBpG;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAErE"}

package/dist/utils/widgets.js

@@ -0,0 +1,90 @@
+/**
+ * Widget registry for MCP server UI widgets
+ *
+ * This module manages widget configuration and validates that widget files exist
+ * at runtime.
+ */
+const OPENAI_WIDGET_CSP = {
+    connect_domains: ['https://api.apify.com'],
+    resource_domains: [
+        'https://mcp.apify.com',
+        'https://images.apifyusercontent.com',
+        'https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com',
+        'https://apify-image-uploads-prod.s3.amazonaws.com',
+    ],
+};
+const OPENAI_WIDGET_BASE_META = {
+    'openai/widgetAccessible': true,
+    'openai/resultCanProduceWidget': true,
+    'openai/widgetPrefersBorder': true,
+    'openai/widgetDomain': 'https://apify.com',
+    'openai/widgetCSP': OPENAI_WIDGET_CSP,
+};
+export const WIDGET_URIS = {
+    SEARCH_ACTORS: 'ui://widget/search-actors.html',
+    ACTOR_RUN: 'ui://widget/actor-run.html',
+};
+/**
+ * Widget registry configuration
+ * Maps widget URIs to their configuration
+ */
+export const WIDGET_REGISTRY = {
+    [WIDGET_URIS.SEARCH_ACTORS]: {
+        uri: WIDGET_URIS.SEARCH_ACTORS,
+        name: 'search-actors-widget',
+        description: 'Interactive Actor search results widget',
+        jsFilename: 'search-actors-widget.js',
+        title: 'Apify Actor Search',
+        meta: {
+            ...OPENAI_WIDGET_BASE_META,
+            'openai/outputTemplate': WIDGET_URIS.SEARCH_ACTORS,
+            'openai/toolInvocation/invoking': 'Searching Apify Store...',
+            'openai/toolInvocation/invoked': 'Found Actors matching your criteria',
+        },
+    },
+    [WIDGET_URIS.ACTOR_RUN]: {
+        uri: WIDGET_URIS.ACTOR_RUN,
+        name: 'actor-run-widget',
+        description: 'Interactive Actor run widget',
+        jsFilename: 'actor-run-widget.js',
+        title: 'Apify Actor Run',
+        meta: {
+            ...OPENAI_WIDGET_BASE_META,
+            'openai/outputTemplate': WIDGET_URIS.ACTOR_RUN,
+            'openai/toolInvocation/invoking': 'Running Apify Actor...',
+            'openai/toolInvocation/invoked': 'Actor run started',
+        },
+    },
+};
+/**
+ * Resolves available widgets by checking if their files exist on the filesystem.
+ *
+ * @param baseDir - Base directory where the server code is located
+ * @returns Map of widget URIs to their resolved state
+ */
+export async function resolveAvailableWidgets(baseDir) {
+    const fs = await import('node:fs');
+    const path = await import('node:path');
+    const resolvedWidgets = new Map();
+    const webDistPath = path.resolve(baseDir, '../web/dist');
+    for (const [uri, config] of Object.entries(WIDGET_REGISTRY)) {
+        const jsPath = path.resolve(webDistPath, config.jsFilename);
+        const exists = fs.existsSync(jsPath);
+        resolvedWidgets.set(uri, {
+            ...config,
+            jsPath,
+            exists,
+        });
+    }
+    return resolvedWidgets;
+}
+/**
+ * Get widget configuration by URI
+ *
+ * @param uri - Widget URI
+ * @returns Widget configuration or undefined if not found
+ */
+export function getWidgetConfig(uri) {
+    return WIDGET_REGISTRY[uri];
+}
+//# sourceMappingURL=widgets.js.map

package/dist/utils/widgets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgets.js","sourceRoot":"","sources":["../../src/utils/widgets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,iBAAiB,GAAG;IACtB,eAAe,EAAE,CAAC,uBAAuB,CAAC;IAC1C,gBAAgB,EAAE;QACd,uBAAuB;QACvB,qCAAqC;QACrC,6DAA6D;QAC7D,mDAAmD;KACtD;CACK,CAAC;AAEX,MAAM,uBAAuB,GAAG;IAC5B,yBAAyB,EAAE,IAAI;IAC/B,+BAA+B,EAAE,IAAI;IACrC,4BAA4B,EAAE,IAAI;IAClC,qBAAqB,EAAE,mBAAmB;IAC1C,kBAAkB,EAAE,iBAAiB;CAC/B,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,aAAa,EAAE,gCAAgC;IAC/C,SAAS,EAAE,4BAA4B;CACjC,CAAC;AAsBX;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAiC;IACzD,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE;QACzB,GAAG,EAAE,WAAW,CAAC,aAAa;QAC9B,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,yCAAyC;QACtD,UAAU,EAAE,yBAAyB;QACrC,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE;YACF,GAAG,uBAAuB;YAC1B,uBAAuB,EAAE,WAAW,CAAC,aAAa;YAClD,gCAAgC,EAAE,0BAA0B;YAC5D,+BAA+B,EAAE,qCAAqC;SACzE;KACJ;IACD,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE;QACrB,GAAG,EAAE,WAAW,CAAC,SAAS;QAC1B,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,8BAA8B;QAC3C,UAAU,EAAE,qBAAqB;QACjC,KAAK,EAAE,iBAAiB;QACxB,IAAI,EAAE;YACF,GAAG,uBAAuB;YAC1B,uBAAuB,EAAE,WAAW,CAAC,SAAS;YAC9C,gCAAgC,EAAE,wBAAwB;YAC1D,+BAA+B,EAAE,mBAAmB;SACvD;KACJ;CACJ,CAAC;AAOF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,OAAe;IACzD,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAEvC,MAAM,eAAe,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAEzD,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAErC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE;YACrB,GAAG,MAAM;YACT,MAAM;YACN,MAAM;SACT,CAAC,CAAC;IACP,CAAC;IAED,OAAO,eAAe,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACvC,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC"}