@apify/actors-mcp-server 0.9.22-beta.0 → 0.9.23-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,11 +1,11 @@
1
1
  import type { ToolTelemetryContext } from '../types.js';
2
+ /** MCP `_meta` key for Apify Actor run information. Namespaced per MCP spec. */
3
+ export declare const APIFY_ACTOR_RUN_META_KEY = "com.apify/ActorRun";
2
4
  /**
3
5
  * Builds usage metadata for MCP response from a source object containing Apify run costs.
4
- * Uses MCP-compliant key names with com.apify/ prefix as per MCP specification.
5
- * @param source - Object containing usage cost information
6
- * @param source.usageTotalUsd - Total cost in USD (optional)
7
- * @param source.usageUsd - Breakdown of costs by resource type (optional)
8
- * @returns Usage metadata object or undefined if no usage data is available
6
+ * Nests fields under the `com.apify/ActorRun` namespaced key as required by the MCP `_meta` spec
7
+ * (https://modelcontextprotocol.io/specification/2025-11-25/basic/index#_meta).
8
+ * @returns `{ 'com.apify/ActorRun': { usageTotalUsd, usageUsd } }`, or undefined if no usage data.
9
9
  */
10
10
  export declare function buildUsageMeta(source: {
11
11
  usageTotalUsd?: number;
@@ -1 +1 @@
1
- {"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/utils/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGxD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAQtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACtC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;;;;;;;;;EAUA;AAED,gFAAgF;AAChF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAUjF"}
1
+ {"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/utils/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGxD,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,uBAAuB,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAOtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACtC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;;;;;;;;;EAUA;AAED,gFAAgF;AAChF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAUjF"}
package/dist/utils/mcp.js CHANGED
@@ -1,18 +1,17 @@
1
1
  import { getHttpStatusCode } from './logging.js';
2
+ /** MCP `_meta` key for Apify Actor run information. Namespaced per MCP spec. */
3
+ export const APIFY_ACTOR_RUN_META_KEY = 'com.apify/ActorRun';
2
4
  /**
3
5
  * Builds usage metadata for MCP response from a source object containing Apify run costs.
4
- * Uses MCP-compliant key names with com.apify/ prefix as per MCP specification.
5
- * @param source - Object containing usage cost information
6
- * @param source.usageTotalUsd - Total cost in USD (optional)
7
- * @param source.usageUsd - Breakdown of costs by resource type (optional)
8
- * @returns Usage metadata object or undefined if no usage data is available
6
+ * Nests fields under the `com.apify/ActorRun` namespaced key as required by the MCP `_meta` spec
7
+ * (https://modelcontextprotocol.io/specification/2025-11-25/basic/index#_meta).
8
+ * @returns `{ 'com.apify/ActorRun': { usageTotalUsd, usageUsd } }`, or undefined if no usage data.
9
9
  */
10
10
  export function buildUsageMeta(source) {
11
11
  const { usageTotalUsd, usageUsd } = source;
12
12
  return usageTotalUsd !== undefined
13
13
  ? {
14
- usageTotalUsd,
15
- usageUsd,
14
+ [APIFY_ACTOR_RUN_META_KEY]: { usageTotalUsd, usageUsd },
16
15
  }
17
16
  : undefined;
18
17
  }
@@ -1 +1 @@
1
- {"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/utils/mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,MAG9B;IACG,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAC3C,OAAO,aAAa,KAAK,SAAS;QAC9B,CAAC,CAAC;YACE,aAAa;YACb,QAAQ;SACX;QACD,CAAC,CAAC,SAAS,CAAC;AACpB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAMhC;IACG,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAEhF,OAAO;QACH,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO;QACP,GAAG,CAAC,SAAS,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;QAC9C,GAAG,CAAC,iBAAiB,KAAK,SAAS,IAAI,EAAE,iBAAiB,EAAE,CAAC;QAC7D,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;KACxC,CAAC;AACN,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,wBAAwB,CAAC,QAAgB,EAAE,KAAc;IACrE,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACjB,OAAO,uBAAuB,QAAQ,MAAM,GAAG,8DAA8D,CAAC;IAClH,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACjB,OAAO,uBAAuB,QAAQ,MAAM,GAAG,+DAA+D,CAAC;IACnH,CAAC;IACD,OAAO,uBAAuB,QAAQ,MAAM,GAAG,8CAA8C,CAAC;AAClG,CAAC"}
1
+ {"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/utils/mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,gFAAgF;AAChF,MAAM,CAAC,MAAM,wBAAwB,GAAG,oBAAoB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAG9B;IACG,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAC3C,OAAO,aAAa,KAAK,SAAS;QAC9B,CAAC,CAAC;YACE,CAAC,wBAAwB,CAAC,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE;SAC1D;QACD,CAAC,CAAC,SAAS,CAAC;AACpB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAMhC;IACG,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAEhF,OAAO;QACH,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO;QACP,GAAG,CAAC,SAAS,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;QAC9C,GAAG,CAAC,iBAAiB,KAAK,SAAS,IAAI,EAAE,iBAAiB,EAAE,CAAC;QAC7D,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;KACxC,CAAC;AACN,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,wBAAwB,CAAC,QAAgB,EAAE,KAAc;IACrE,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACjB,OAAO,uBAAuB,QAAQ,MAAM,GAAG,8DAA8D,CAAC;IAClH,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;QACjB,OAAO,uBAAuB,QAAQ,MAAM,GAAG,+DAA+D,CAAC;IACnH,CAAC;IACD,OAAO,uBAAuB,QAAQ,MAAM,GAAG,8CAA8C,CAAC;AAClG,CAAC"}