@apify/actors-mcp-server 0.9.12-beta.0 → 0.9.12-beta.2

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,15 +1,21 @@
1
1
  import type { ProgressNotification } from '@modelcontextprotocol/sdk/types.js';
2
2
  import type { ApifyClient } from '../apify_client.js';
3
3
  export declare class ProgressTracker {
4
- private progressToken;
5
- private sendNotification;
4
+ private progressToken?;
5
+ private sendNotification?;
6
6
  private currentProgress;
7
7
  private intervalId?;
8
8
  private taskId?;
9
- constructor(progressToken: string | number, sendNotification: (notification: ProgressNotification) => Promise<void>, taskId?: string);
9
+ private onStatusMessage?;
10
+ constructor(options: {
11
+ progressToken?: string | number;
12
+ sendNotification?: (notification: ProgressNotification) => Promise<void>;
13
+ taskId?: string;
14
+ onStatusMessage?: (message: string) => Promise<void>;
15
+ });
10
16
  updateProgress(message?: string): Promise<void>;
11
17
  startActorRunUpdates(runId: string, apifyClient: ApifyClient, actorName: string): void;
12
18
  stop(): void;
13
19
  }
14
- export declare function createProgressTracker(progressToken: string | number | undefined, sendNotification: ((notification: ProgressNotification) => Promise<void>) | undefined, taskId?: string): ProgressTracker | null;
20
+ export declare function createProgressTracker(progressToken: string | number | undefined, sendNotification: ((notification: ProgressNotification) => Promise<void>) | undefined, taskId?: string, onStatusMessage?: (message: string) => Promise<void>): ProgressTracker | null;
15
21
  //# sourceMappingURL=progress.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/utils/progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,qBAAa,eAAe;IACxB,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,gBAAgB,CAAwD;IAChF,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,MAAM,CAAC,CAAS;gBAGpB,aAAa,EAAE,MAAM,GAAG,MAAM,EAC9B,gBAAgB,EAAE,CAAC,YAAY,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,EACvE,MAAM,CAAC,EAAE,MAAM;IAOb,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BrD,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAkCtF,IAAI,IAAI,IAAI;CAMf;AAED,wBAAgB,qBAAqB,CACjC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EAC1C,gBAAgB,EAAE,CAAC,CAAC,YAAY,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,EACrF,MAAM,CAAC,EAAE,MAAM,GAChB,eAAe,GAAG,IAAI,CAMxB"}
1
+ {"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/utils/progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,qBAAa,eAAe;IACxB,OAAO,CAAC,aAAa,CAAC,CAAkB;IACxC,OAAO,CAAC,gBAAgB,CAAC,CAAwD;IACjF,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,eAAe,CAAC,CAAqC;gBAEjD,OAAO,EAAE;QACjB,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAChC,gBAAgB,CAAC,EAAE,CAAC,YAAY,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACzE,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACxD;IAOK,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCrD,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAkCtF,IAAI,IAAI,IAAI;CAMf;AAED,wBAAgB,qBAAqB,CACjC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EAC1C,gBAAgB,EAAE,CAAC,CAAC,YAAY,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,EACrF,MAAM,CAAC,EAAE,MAAM,EACf,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACrD,eAAe,GAAG,IAAI,CAOxB"}
@@ -1,6 +1,6 @@
1
1
  import { PROGRESS_NOTIFICATION_INTERVAL_MS } from '../const.js';
2
2
  export class ProgressTracker {
3
- constructor(progressToken, sendNotification, taskId) {
3
+ constructor(options) {
4
4
  Object.defineProperty(this, "progressToken", {
5
5
  enumerable: true,
6
6
  configurable: true,
@@ -31,33 +31,52 @@ export class ProgressTracker {
31
31
  writable: true,
32
32
  value: void 0
33
33
  });
34
- this.progressToken = progressToken;
35
- this.sendNotification = sendNotification;
36
- this.taskId = taskId;
34
+ Object.defineProperty(this, "onStatusMessage", {
35
+ enumerable: true,
36
+ configurable: true,
37
+ writable: true,
38
+ value: void 0
39
+ });
40
+ this.progressToken = options.progressToken;
41
+ this.sendNotification = options.sendNotification;
42
+ this.taskId = options.taskId;
43
+ this.onStatusMessage = options.onStatusMessage;
37
44
  }
38
45
  async updateProgress(message) {
39
46
  this.currentProgress += 1;
40
- try {
41
- const notification = {
42
- method: 'notifications/progress',
43
- params: {
44
- progressToken: this.progressToken,
45
- progress: this.currentProgress,
46
- ...(message && { message }),
47
- },
48
- // Per MCP spec: progress notifications during task execution should include related-task metadata
49
- ...(this.taskId && {
50
- _meta: {
51
- 'io.modelcontextprotocol/related-task': {
52
- taskId: this.taskId,
53
- },
47
+ // Send progress notification only if progressToken and sendNotification are available
48
+ if (this.progressToken && this.sendNotification) {
49
+ try {
50
+ const notification = {
51
+ method: 'notifications/progress',
52
+ params: {
53
+ progressToken: this.progressToken,
54
+ progress: this.currentProgress,
55
+ ...(message && { message }),
54
56
  },
55
- }),
56
- };
57
- await this.sendNotification(notification);
57
+ // Per MCP spec: progress notifications during task execution should include related-task metadata
58
+ ...(this.taskId && {
59
+ _meta: {
60
+ 'io.modelcontextprotocol/related-task': {
61
+ taskId: this.taskId,
62
+ },
63
+ },
64
+ }),
65
+ };
66
+ await this.sendNotification(notification);
67
+ }
68
+ catch {
69
+ // Silent fail - don't break execution
70
+ }
58
71
  }
59
- catch {
60
- // Silent fail - don't break execution
72
+ // Update task statusMessage if callback is provided
73
+ if (this.onStatusMessage && message) {
74
+ try {
75
+ await this.onStatusMessage(message);
76
+ }
77
+ catch {
78
+ // Silent fail - don't break execution
79
+ }
61
80
  }
62
81
  }
63
82
  startActorRunUpdates(runId, apifyClient, actorName) {
@@ -96,10 +115,11 @@ export class ProgressTracker {
96
115
  }
97
116
  }
98
117
  }
99
- export function createProgressTracker(progressToken, sendNotification, taskId) {
100
- if (!progressToken || !sendNotification) {
118
+ export function createProgressTracker(progressToken, sendNotification, taskId, onStatusMessage) {
119
+ // Create tracker if we have either progress notification support or a status message callback
120
+ if ((!progressToken || !sendNotification) && !onStatusMessage) {
101
121
  return null;
102
122
  }
103
- return new ProgressTracker(progressToken, sendNotification, taskId);
123
+ return new ProgressTracker({ progressToken, sendNotification, taskId, onStatusMessage });
104
124
  }
105
125
  //# sourceMappingURL=progress.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/utils/progress.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/utils/progress.ts"],"names":[],"mappings":"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"}