@apify/actors-mcp-server 0.9.20-beta.9 → 0.9.21-beta.0

package/dist/types.d.ts

@@ -323,34 +323,48 @@ export type ToolTelemetryContext = {
 };
 export type CallDiagnostics = Pick<ToolCallTelemetryProperties, 'failure_category' | 'failure_http_status' | 'failure_detail' | 'actor_name' | 'actor_id' | 'validation_keyword' | 'validation_path' | 'validation_missing_property' | 'validation_additional_property' | 'validation_error_count'>;
 /**
- * Internal server mode that controls which tool variants, descriptions, and response
- * formats are served. Every internal call site (tool loading, category resolution,
- * server instructions) uses this type.
+ * Server mode — controls which tool variants, descriptions, and response formats are served.
  *
  * - `'default'` — standard MCP tools for generic clients (sync/async execution, text responses)
- * - `'openai'` — OpenAI-specific tool variants (always-async execution, widget metadata)
+ * - `'apps'`    — MCP Apps tool variants (always-async execution, widget metadata)
  *
- * **Relationship to {@link UiMode}:** `ServerMode` is the internal representation;
- * `UiMode` is the external API surface exposed to callers (currently only `'openai'`).
- * The conversion happens in `ActorsMcpServer` constructor: `options.uiMode ?? 'default'`.
+ * The `'apps'` name comes from the [MCP Apps specification (2026-01-26)](https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/2026-01-26/apps.mdx),
+ * the open standard for widget-embedded UI in MCP clients. The value was previously
+ * named `'openai'` but is renamed here to reflect that the protocol is no longer
+ * OpenAI-specific; `'openai'` is kept as a deprecated alias at CLI/env ingestion
+ * (see {@link parseServerMode}) and is silently normalized to `'apps'`.
  */
-export type ServerMode = 'default' | 'openai';
+export declare const ServerMode: {
+    readonly DEFAULT: "default";
+    readonly APPS: "apps";
+};
+export type ServerMode = (typeof ServerMode)[keyof typeof ServerMode];
 /** All valid server modes, for iteration in tests and caches. */
 export declare const SERVER_MODES: readonly ServerMode[];
 /**
- * External API surface for selecting a UI mode — passed via `options.uiMode` in
- * {@link ActorsMcpServerOptions}. Excludes `'default'` because the absence of a
- * UI mode (`undefined`) maps to `ServerMode = 'default'` internally.
+ * Server mode option — a concrete {@link ServerMode} or `'auto'` to resolve from
+ * the client's `initialize` capabilities at connection time.
+ */
+export type ServerModeOption = ServerMode | 'auto';
+/**
+ * Parse an untrusted raw mode string (from CLI flag, env var, or URL param) into a {@link ServerModeOption}.
  *
- * **Relationship to {@link ServerMode}:** `UiMode` is a strict subset of `ServerMode`.
- * Callers set `uiMode?: UiMode`; the server normalizes it to `ServerMode` at construction.
+ * Accepts:
+ * - `'default'` / `'apps'` — canonical values
+ * - `'true'` / `'on'` / `'false'` / `'off'` — CLI shorthand
+ * - `'auto'` — resolve from client capabilities (default for missing/unknown input)
+ * - `'openai'` — deprecated alias for `'apps'` (pre-MCP-Apps naming); silently normalized
+ *
+ * Missing or unrecognized input returns `'auto'`, so a typo in an env var becomes
+ * capability-driven resolution instead of silently forcing default mode.
  */
-export type UiMode = Exclude<ServerMode, 'default'>;
+export declare function parseServerMode(rawMode: string | null | undefined): ServerModeOption;
 /**
- * Parse an untrusted string into a valid UiMode, returning `undefined` for invalid values.
- * Use at ingestion boundaries (URL params, env vars) to prevent invalid modes from propagating.
+ * Resolve a {@link ServerModeOption} to a concrete {@link ServerMode}.
+ * Concrete modes are returned as-is. `'auto'` resolves to {@link ServerMode.APPS}
+ * when the client advertises MCP Apps UI support, {@link ServerMode.DEFAULT} otherwise.
  */
-export declare function parseUiMode(value: string | null | undefined): UiMode | undefined;
+export declare function resolveServerMode(option: ServerModeOption, clientSupportsUi: boolean): ServerMode;
 /**
  * Parameters for executing a direct actor tool (`type: 'actor'`).
  * Used by ActorExecutor implementations.
@@ -389,7 +403,7 @@ export type ActorExecutionResult = {
 /**
  * Executor for direct actor tools (`type: 'actor'`).
  * Selected at server construction time based on serverMode.
- * Default mode runs synchronously; OpenAI mode runs async with widget metadata.
+ * Default mode runs synchronously; apps mode runs async with widget metadata.
  */
 export type ActorExecutor = {
     executeActorTool(params: ActorExecutionParams): Promise<ActorExecutionResult>;
@@ -490,12 +504,16 @@ export type ActorsMcpServerOptions = {
      */
     token?: string;
     /**
-     * UI mode for tool responses.
-     * - 'openai': OpenAI specific widget rendering
-     * If not specified, defaults to 'default' mode (no widget rendering).
-     * Normalized to {@link ServerMode} at server construction.
+     * Server mode — controls tool variants and response formats. See {@link ServerMode}.
+     * Pass `'auto'` (or omit) to resolve from the client's `initialize` capabilities;
+     * pass `'default'` or `'apps'` to force a specific mode and skip auto-detect.
+     * Defaults to `'auto'` when unset.
+     */
+    serverMode?: ServerModeOption;
+    /**
+     * @deprecated Use `serverMode` instead.
      */
-    uiMode?: UiMode;
+    uiMode?: string;
 };
 export type StructuredActorCard = {
     title?: string;

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,16 +1,56 @@
+/**
+ * Server mode — controls which tool variants, descriptions, and response formats are served.
+ *
+ * - `'default'` — standard MCP tools for generic clients (sync/async execution, text responses)
+ * - `'apps'`    — MCP Apps tool variants (always-async execution, widget metadata)
+ *
+ * The `'apps'` name comes from the [MCP Apps specification (2026-01-26)](https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/2026-01-26/apps.mdx),
+ * the open standard for widget-embedded UI in MCP clients. The value was previously
+ * named `'openai'` but is renamed here to reflect that the protocol is no longer
+ * OpenAI-specific; `'openai'` is kept as a deprecated alias at CLI/env ingestion
+ * (see {@link parseServerMode}) and is silently normalized to `'apps'`.
+ */
+export const ServerMode = {
+    DEFAULT: 'default',
+    APPS: 'apps',
+};
 /** All valid server modes, for iteration in tests and caches. */
-export const SERVER_MODES = ['default', 'openai'];
-/** Set of valid UiMode values for O(1) membership checks at runtime. */
-const UI_MODES = new Set(SERVER_MODES.filter((m) => m !== 'default'));
+export const SERVER_MODES = Object.values(ServerMode);
+/**
+ * Parse an untrusted raw mode string (from CLI flag, env var, or URL param) into a {@link ServerModeOption}.
+ *
+ * Accepts:
+ * - `'default'` / `'apps'` — canonical values
+ * - `'true'` / `'on'` / `'false'` / `'off'` — CLI shorthand
+ * - `'auto'` — resolve from client capabilities (default for missing/unknown input)
+ * - `'openai'` — deprecated alias for `'apps'` (pre-MCP-Apps naming); silently normalized
+ *
+ * Missing or unrecognized input returns `'auto'`, so a typo in an env var becomes
+ * capability-driven resolution instead of silently forcing default mode.
+ */
+export function parseServerMode(rawMode) {
+    if (!rawMode)
+        return 'auto';
+    if (rawMode === 'true' || rawMode === 'on' || rawMode === ServerMode.APPS || rawMode === 'openai')
+        return ServerMode.APPS;
+    if (rawMode === 'false' || rawMode === 'off' || rawMode === ServerMode.DEFAULT)
+        return ServerMode.DEFAULT;
+    if (rawMode === 'auto')
+        return 'auto';
+    return 'auto';
+}
 /**
- * Parse an untrusted string into a valid UiMode, returning `undefined` for invalid values.
- * Use at ingestion boundaries (URL params, env vars) to prevent invalid modes from propagating.
+ * Resolve a {@link ServerModeOption} to a concrete {@link ServerMode}.
+ * Concrete modes are returned as-is. `'auto'` resolves to {@link ServerMode.APPS}
+ * when the client advertises MCP Apps UI support, {@link ServerMode.DEFAULT} otherwise.
  */
-export function parseUiMode(value) {
-    if (!value)
-        return undefined;
-    if (value === 'true')
-        return 'openai'; // 'true' is the new standard; 'openai' is deprecated alias
-    return UI_MODES.has(value) ? value : undefined;
+export function resolveServerMode(option, clientSupportsUi) {
+    if (option !== 'auto')
+        return option;
+    // TODO: re-enable auto-detect from client capabilities. Disabled for the
+    // initial release so APPS mode is opt-in via `?ui=apps` or `UI_MODE=apps`.
+    // return clientSupportsUi ? ServerMode.APPS : ServerMode.DEFAULT;
+    void clientSupportsUi;
+    return ServerMode.DEFAULT;
 }
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAmZA,iEAAiE;AACjE,MAAM,CAAC,MAAM,YAAY,GAA0B,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAC;AAYlF,wEAAwE;AACxE,MAAM,QAAQ,GAAwB,IAAI,GAAG,CAAS,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC;AAEhH;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAgC;IACxD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,QAAQ,CAAC,CAAC,2DAA2D;IAClG,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAgB,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAqYA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;CACN,CAAC;AAGX,iEAAiE;AACjE,MAAM,CAAC,MAAM,YAAY,GAA0B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAQ7E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,OAAkC;IAC9D,IAAI,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC;IAC5B,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,UAAU,CAAC,IAAI,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC,IAAI,CAAC;IAC1H,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,UAAU,CAAC,OAAO;QAAE,OAAO,UAAU,CAAC,OAAO,CAAC;IAC1G,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACtC,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAwB,EAAE,gBAAyB;IACjF,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACrC,yEAAyE;IACzE,2EAA2E;IAC3E,kEAAkE;IAClE,KAAK,gBAAgB,CAAC;IACtB,OAAO,UAAU,CAAC,OAAO,CAAC;AAC9B,CAAC"}

package/dist/utils/actor_details.d.ts

@@ -36,7 +36,7 @@ export type ActorDetailsResult = {
 };
 export declare function fetchActorDetails(apifyClient: ApifyClient, actorName: string, cardOptions?: ActorCardOptions): Promise<ActorDetailsResult | null>;
 /**
- * Build the widget actor-details payload for the openai variant.
+ * Build the widget actor-details payload for the apps variant.
  * Returns the Actor URL and the structured `actorDetails` object.
  */
 export declare function buildActorDetailsForWidget(details: ActorDetailsResult, userTier: PricingTier): {

package/dist/utils/actor_details.js

@@ -81,7 +81,7 @@ export async function fetchActorDetails(apifyClient, actorName, cardOptions) {
     }
 }
 /**
- * Build the widget actor-details payload for the openai variant.
+ * Build the widget actor-details payload for the apps variant.
  * Returns the Actor URL and the structured `actorDetails` object.
  */
 export function buildActorDetailsForWidget(details, userTier) {

package/dist/utils/server-instructions/index.d.ts

@@ -1,10 +1,22 @@
 /**
- * Server instructions entry point.
- * Selects the appropriate instructions based on server mode.
+ * Server instructions — mode-aware text served to clients.
+ *
+ * Apps-only sections (widget workflow, widget tool disambiguation) are included
+ * only when the resolved server mode is `'apps'`. Default-mode clients never
+ * see tool names like `search-actors-internal` or `fetch-actor-details-internal`,
+ * avoiding hallucinated calls to tools absent from `tools/list`.
+ *
+ * Note: the `-widget` suffix split (separating widget-backed tools from silent
+ * variants by name) is planned in follow-up PRs. Until then, widget rendering
+ * happens on the base tool names (`call-actor`, `search-actors`,
+ * `fetch-actor-details`) in apps mode.
  */
-import type { ServerMode } from '../../types.js';
+import { ServerMode } from '../../types.js';
 /**
- * Build server instructions for the given server mode.
+ * Build server instructions for the given mode.
+ *
+ * Apps-only sections are omitted in default mode to prevent models from
+ * attempting to call widget tools that are not registered.
  */
 export declare function getServerInstructions(mode?: ServerMode): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/server-instructions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/server-instructions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAUjD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,UAAsB,GAAG,MAAM,CAE1E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/server-instructions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,UAA+B,GAAG,MAAM,CA0DnF"}

package/dist/utils/server-instructions/index.js

@@ -1,18 +1,80 @@
 /**
- * Server instructions entry point.
- * Selects the appropriate instructions based on server mode.
+ * Server instructions — mode-aware text served to clients.
+ *
+ * Apps-only sections (widget workflow, widget tool disambiguation) are included
+ * only when the resolved server mode is `'apps'`. Default-mode clients never
+ * see tool names like `search-actors-internal` or `fetch-actor-details-internal`,
+ * avoiding hallucinated calls to tools absent from `tools/list`.
+ *
+ * Note: the `-widget` suffix split (separating widget-backed tools from silent
+ * variants by name) is planned in follow-up PRs. Until then, widget rendering
+ * happens on the base tool names (`call-actor`, `search-actors`,
+ * `fetch-actor-details`) in apps mode.
  */
-import { getDefaultInstructions } from './default.js';
-import { getOpenaiInstructions } from './openai.js';
-/** Mode → instructions builder. Add new modes here. */
-const instructionsByMode = {
-    default: getDefaultInstructions,
-    openai: getOpenaiInstructions,
-};
+import { HelperTools, RAG_WEB_BROWSER } from '../../const.js';
+import { ServerMode } from '../../types.js';
 /**
- * Build server instructions for the given server mode.
+ * Build server instructions for the given mode.
+ *
+ * Apps-only sections are omitted in default mode to prevent models from
+ * attempting to call widget tools that are not registered.
  */
-export function getServerInstructions(mode = 'default') {
-    return instructionsByMode[mode]();
+export function getServerInstructions(mode = ServerMode.DEFAULT) {
+    const isApps = mode === ServerMode.APPS;
+    return `
+Apify is the world's largest marketplace of tools for web scraping, data extraction, and web automation.
+These tools are called **Actors**. They enable you to extract structured data from social media, e-commerce, search engines, maps, travel sites, and many other sources.
+
+## Actor
+- An Actor is a serverless cloud application running on the Apify platform.
+- Use the Actor's **README** to understand its capabilities.
+- Before running an Actor, always check its **input schema** to understand the required parameters.
+
+## Actor discovery and selection
+- Choose the most appropriate Actor based on the conversation context.
+- Search the Apify Store first; a relevant Actor likely already exists.
+- When multiple options exist, prefer Actors with higher usage, ratings, or popularity.
+- Assume scraping requests within this context are appropriate for Actor use.
+- Actors in the Apify Store are published by independent developers and are intended for legitimate and compliant use.
+
+## Actor execution workflow
+- Actors take input and produce output.
+- Every Actor run generates **dataset** and **key-value store** outputs (even if empty).
+- Actor execution may take time, and outputs can be large.
+- Large datasets can be paginated to retrieve results efficiently.
+
+## Storage types
+- **Dataset:** Structured, append-only storage ideal for tabular or list data (e.g., scraped items).
+- **Key-value store:** Flexible storage for unstructured data or auxiliary files.
+${isApps ? `
+## Widget workflow (applies when tool responses include widget metadata)
+Some clients render widget-backed Actor tools: the response includes a live UI that automatically polls run status. When a widget is rendered, follow-up status polling by the model is a forbidden duplicate.
+
+- **Never call \`${HelperTools.ACTOR_RUNS_GET}\` after a widget-backed \`${HelperTools.ACTOR_CALL}\` response.** The widget renders live progress and polls itself — stop after the widget response and defer to it for run status.
+- When \`${HelperTools.ACTOR_CALL}\` runs without a widget (the tool response is plain text / structured data only), polling \`${HelperTools.ACTOR_RUNS_GET}\` for status is expected.
+- Follow-up PRs will split widget-backed tools into a dedicated \`-widget\`-suffixed namespace; until then, widget rendering happens on the base tool names when the client supports it.
+` : ''}
+## Tool dependencies and disambiguation
+
+### Tool dependencies
+- \`${HelperTools.ACTOR_CALL}\`:
+  - Use \`${HelperTools.ACTOR_GET_DETAILS}\` first to obtain the Actor's input schema.
+  - Then call with proper input to execute the Actor.
+  - For MCP server Actors, use format "actorName:toolName" to call specific tools.
+  - Supports async execution via the \`async\` parameter:
+    - \`async: false\` or unset: waits for completion and returns results immediately.
+    - \`async: true\`: starts the run and returns immediately with a runId.
+
+### Tool disambiguation
+- **\`${HelperTools.ACTOR_OUTPUT_GET}\` vs \`${HelperTools.DATASET_GET_ITEMS}\`:**
+  Use \`${HelperTools.ACTOR_OUTPUT_GET}\` for Actor run outputs and \`${HelperTools.DATASET_GET_ITEMS}\` for direct dataset access.
+- **\`${HelperTools.STORE_SEARCH}\` vs \`${HelperTools.ACTOR_GET_DETAILS}\`:**
+  \`${HelperTools.STORE_SEARCH}\` finds Actors; \`${HelperTools.ACTOR_GET_DETAILS}\` retrieves detailed info, README, and schema for a specific Actor.
+${isApps ? `- **Widget-backed variants (when the client supports them):** Some \`${HelperTools.STORE_SEARCH}\` / \`${HelperTools.ACTOR_GET_DETAILS}\` responses render an interactive widget for the user. Prefer the widget-backed variant when the user explicitly asks to *see*, *browse*, or *view* something; when the next step is to actually run an Actor or perform a programmatic flow, prefer a silent lookup if such a variant is available (for example, \`${HelperTools.STORE_SEARCH_INTERNAL}\` or \`${HelperTools.ACTOR_GET_DETAILS_INTERNAL}\`), otherwise use the standard lookup tools. A \`-widget\` suffix split is planned in a follow-up PR; until then, widget rendering is selected by the server based on client capabilities.
+` : ''}- **\`${HelperTools.STORE_SEARCH}\` vs ${RAG_WEB_BROWSER}:**
+  \`${HelperTools.STORE_SEARCH}\` finds robust and reliable Actors for specific websites; ${RAG_WEB_BROWSER} is a general and versatile web scraping tool.
+- **Dedicated Actor tools (e.g. ${RAG_WEB_BROWSER}) vs \`${HelperTools.ACTOR_CALL}\`:**
+  Prefer dedicated tools when available; use \`${HelperTools.ACTOR_CALL}\` only when no specialized tool exists in the Apify store.
+`;
 }
 //# sourceMappingURL=index.js.map

package/dist/utils/server-instructions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/server-instructions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,uDAAuD;AACvD,MAAM,kBAAkB,GAAqC;IACzD,OAAO,EAAE,sBAAsB;IAC/B,MAAM,EAAE,qBAAqB;CAChC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAmB,SAAS;IAC9D,OAAO,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;AACtC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/server-instructions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAmB,UAAU,CAAC,OAAO;IACvE,MAAM,MAAM,GAAG,IAAI,KAAK,UAAU,CAAC,IAAI,CAAC;IAExC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;EAyBT,MAAM,CAAC,CAAC,CAAC;;;;mBAIQ,WAAW,CAAC,cAAc,8BAA8B,WAAW,CAAC,UAAU;WACtF,WAAW,CAAC,UAAU,gGAAgG,WAAW,CAAC,cAAc;;CAE1J,CAAC,CAAC,CAAC,EAAE;;;;MAIA,WAAW,CAAC,UAAU;YAChB,WAAW,CAAC,iBAAiB;;;;;;;;QAQjC,WAAW,CAAC,gBAAgB,WAAW,WAAW,CAAC,iBAAiB;UAClE,WAAW,CAAC,gBAAgB,kCAAkC,WAAW,CAAC,iBAAiB;QAC7F,WAAW,CAAC,YAAY,WAAW,WAAW,CAAC,iBAAiB;MAClE,WAAW,CAAC,YAAY,sBAAsB,WAAW,CAAC,iBAAiB;EAC/E,MAAM,CAAC,CAAC,CAAC,wEAAwE,WAAW,CAAC,YAAY,UAAU,WAAW,CAAC,iBAAiB,wTAAwT,WAAW,CAAC,qBAAqB,WAAW,WAAW,CAAC,0BAA0B;CAC3hB,CAAC,CAAC,CAAC,EAAE,SAAS,WAAW,CAAC,YAAY,SAAS,eAAe;MACzD,WAAW,CAAC,YAAY,8DAA8D,eAAe;kCACzE,eAAe,UAAU,WAAW,CAAC,UAAU;iDAChC,WAAW,CAAC,UAAU;CACtE,CAAC;AACF,CAAC"}

package/dist/utils/tools.d.ts

@@ -1,4 +1,5 @@
-import type { CallDiagnostics, ServerMode, ToolBase, ToolEntry } from '../types.js';
+import type { CallDiagnostics, ToolBase, ToolEntry } from '../types.js';
+import { ServerMode } from '../types.js';
 /**
  * Returns the canonical full name for a tool.
  * For actor tools this is actorFullName (e.g. "apify/rag-web-browser"),

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

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/utils/tools.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAc,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAmB,MAAM,aAAa,CAAC;AAGjH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAOvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAGlE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,YAAY,GAAG,UAAU,CAAC,CAKvH;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAUpG;AAED,KAAK,sBAAsB,GAAG;IAC1B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AA0BF;;;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;AAQD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAsBnE"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/utils/tools.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAc,QAAQ,EAAE,SAAS,EAAmB,MAAM,aAAa,CAAC;AACrG,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAOvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAGlE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,YAAY,GAAG,UAAU,CAAC,CAKvH;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAUpG;AAED,KAAK,sBAAsB,GAAG;IAC1B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AA0BF;;;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;AAQD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAsBnE"}

package/dist/utils/tools.js

@@ -1,4 +1,5 @@
 import { SKYFIRE_ENABLED_TOOLS, SKYFIRE_PAY_ID_PROPERTY_DESCRIPTION, SKYFIRE_TOOL_INSTRUCTIONS, } from '../const.js';
+import { ServerMode } from '../types.js';
 import { fixZodSchemaRequired } from './ajv.js';
 /**
  * Returns the canonical full name for a tool.
@@ -52,7 +53,7 @@ export function extractActorName(tool, args) {
 }
 /**
  * Strips widget-specific metadata (openai/* and ui keys) from tool metadata.
- * Used to hide widget metadata in non-openai modes.
+ * Used to hide widget metadata in non-apps modes.
  */
 function stripWidgetMeta(meta) {
     if (!meta)
@@ -78,7 +79,7 @@ function fixZodInputSchemaRequired(inputSchema) {
  */
 export function getToolPublicFieldOnly(tool, options = {}) {
     const { mode, filterWidgetMeta = false } = options;
-    const meta = filterWidgetMeta && mode !== 'openai'
+    const meta = filterWidgetMeta && mode !== ServerMode.APPS
         ? stripWidgetMeta(tool._meta)
         : tool._meta;
     return {

package/dist/utils/tools.js.map

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

package/dist/utils/tools_loader.d.ts

@@ -1,18 +1,16 @@
 /**
- * Shared logic for loading tools based on Input type.
- * This eliminates duplication between stdio.ts and processParamsGetTools.
+ * Two-phase tool loading: {@link getActors} fetches Actor metadata (async, mode-agnostic);
+ * {@link loadToolsFromInput} runs both in sequence.
  */
 import type { ApifyClient } from 'apify-client';
-import type { ActorStore, Input, ServerMode, ToolEntry } 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 mode Server mode for tool variant resolution
- * @param actorStore
- * @returns An array of tool entries
- */
+import type { ActorStore, Input, ToolEntry } from '../types.js';
+import { ServerMode } from '../types.js';
+/** Fetch Actor tool entries for all Actor names in `input`. */
+export declare function getActors(input: Input, apifyClient: ApifyClient, actorStore?: ActorStore): Promise<ToolEntry[]>;
+/** Build a restore {@link Input} from concrete tool names: internal names → `tools`, actor names → `actors`. */
+export declare function toolNamesToInput(toolNames: string[]): Input;
+/** Compose the final tool list from pre-fetched actor tools and the original input for the given mode. */
+export declare function getToolsForServerMode(input: Input, actorTools: ToolEntry[], mode?: ServerMode): ToolEntry[];
+/** Convenience wrapper: {@link getActors} + {@link getToolsForServerMode} in sequence. */
 export declare function loadToolsFromInput(input: Input, apifyClient: ApifyClient, mode?: ServerMode, actorStore?: ActorStore): 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;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAShD,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAgB,SAAS,EAAE,MAAM,aAAa,CAAC;AA0B1F;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACpC,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,EACxB,IAAI,GAAE,UAAsB,EAC5B,UAAU,CAAC,EAAE,UAAU,GACxB,OAAO,CAAC,SAAS,EAAE,CAAC,CAkKtB"}
+{"version":3,"file":"tools_loader.d.ts","sourceRoot":"","sources":["../../src/utils/tools_loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAShD,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAgB,SAAS,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAgB,UAAU,EAAE,MAAM,aAAa,CAAC;AAqGvD,+DAA+D;AAC/D,wBAAsB,SAAS,CAC3B,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,EACxB,UAAU,CAAC,EAAE,UAAU,GACxB,OAAO,CAAC,SAAS,EAAE,CAAC,CAKtB;AAED,gHAAgH;AAChH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,CAqB3D;AAED,0GAA0G;AAC1G,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,IAAI,GAAE,UAA+B,GAAG,SAAS,EAAE,CAkH/H;AAED,0FAA0F;AAC1F,wBAAsB,kBAAkB,CACpC,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,EACxB,IAAI,GAAE,UAA+B,EACrC,UAAU,CAAC,EAAE,UAAU,GACxB,OAAO,CAAC,SAAS,EAAE,CAAC,CAGtB"}