@apify/actors-mcp-server 0.10.5-beta.0 → 0.10.5-beta.10
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.
- package/dist/apify_client.d.ts.map +1 -1
- package/dist/apify_client.js +16 -1
- package/dist/apify_client.js.map +1 -1
- package/dist/const.d.ts +1 -1
- package/dist/const.d.ts.map +1 -1
- package/dist/const.js +1 -3
- package/dist/const.js.map +1 -1
- package/dist/dev_server.d.ts.map +1 -1
- package/dist/dev_server.js +24 -5
- package/dist/dev_server.js.map +1 -1
- package/dist/mcp/server.d.ts +3 -2
- package/dist/mcp/server.d.ts.map +1 -1
- package/dist/mcp/server.js +96 -51
- package/dist/mcp/server.js.map +1 -1
- package/dist/mcp/utils.d.ts +1 -1
- package/dist/mcp/utils.js +1 -1
- package/dist/tools/actor_executor.d.ts +10 -0
- package/dist/tools/actor_executor.d.ts.map +1 -0
- package/dist/tools/actor_executor.js +79 -0
- package/dist/tools/actor_executor.js.map +1 -0
- package/dist/tools/apps/call_actor.d.ts +0 -1
- package/dist/tools/apps/call_actor.d.ts.map +1 -1
- package/dist/tools/apps/call_actor.js +8 -54
- package/dist/tools/apps/call_actor.js.map +1 -1
- package/dist/tools/apps/call_actor_widget.d.ts.map +1 -1
- package/dist/tools/apps/call_actor_widget.js +8 -32
- package/dist/tools/apps/call_actor_widget.js.map +1 -1
- package/dist/tools/apps/get_actor_run_widget.d.ts.map +1 -1
- package/dist/tools/apps/get_actor_run_widget.js +15 -9
- package/dist/tools/apps/get_actor_run_widget.js.map +1 -1
- package/dist/tools/categories.d.ts +6 -0
- package/dist/tools/categories.d.ts.map +1 -1
- package/dist/tools/categories.js +7 -1
- package/dist/tools/categories.js.map +1 -1
- package/dist/tools/core/actor_run_response.d.ts +127 -0
- package/dist/tools/core/actor_run_response.d.ts.map +1 -0
- package/dist/tools/core/actor_run_response.js +551 -0
- package/dist/tools/core/actor_run_response.js.map +1 -0
- package/dist/tools/core/actor_tools_factory.d.ts +8 -3
- package/dist/tools/core/actor_tools_factory.d.ts.map +1 -1
- package/dist/tools/core/actor_tools_factory.js +39 -15
- package/dist/tools/core/actor_tools_factory.js.map +1 -1
- package/dist/tools/core/call_actor_common.d.ts +19 -39
- package/dist/tools/core/call_actor_common.d.ts.map +1 -1
- package/dist/tools/core/call_actor_common.js +196 -129
- package/dist/tools/core/call_actor_common.js.map +1 -1
- package/dist/tools/core/fetch_actor_details_common.d.ts.map +1 -1
- package/dist/tools/core/fetch_actor_details_common.js +1 -0
- package/dist/tools/core/fetch_actor_details_common.js.map +1 -1
- package/dist/tools/core/get_actor_run_common.d.ts +10 -49
- package/dist/tools/core/get_actor_run_common.d.ts.map +1 -1
- package/dist/tools/core/get_actor_run_common.js +51 -86
- package/dist/tools/core/get_actor_run_common.js.map +1 -1
- package/dist/tools/default/call_actor.d.ts +0 -2
- package/dist/tools/default/call_actor.d.ts.map +1 -1
- package/dist/tools/default/call_actor.js +5 -85
- package/dist/tools/default/call_actor.js.map +1 -1
- package/dist/tools/default/get_actor_run.d.ts +1 -2
- package/dist/tools/default/get_actor_run.d.ts.map +1 -1
- package/dist/tools/default/get_actor_run.js +12 -6
- package/dist/tools/default/get_actor_run.js.map +1 -1
- package/dist/tools/index.d.ts +1 -2
- package/dist/tools/index.d.ts.map +1 -1
- package/dist/tools/index.js +1 -2
- package/dist/tools/index.js.map +1 -1
- package/dist/tools/structured_output_schemas.d.ts +258 -51
- package/dist/tools/structured_output_schemas.d.ts.map +1 -1
- package/dist/tools/structured_output_schemas.js +128 -68
- package/dist/tools/structured_output_schemas.js.map +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/dist/types.d.ts +26 -1
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js.map +1 -1
- package/dist/utils/mcp.d.ts +6 -0
- package/dist/utils/mcp.d.ts.map +1 -1
- package/dist/utils/mcp.js +30 -0
- package/dist/utils/mcp.js.map +1 -1
- package/dist/utils/progress.d.ts +1 -0
- package/dist/utils/progress.d.ts.map +1 -1
- package/dist/utils/progress.js +2 -2
- package/dist/utils/progress.js.map +1 -1
- package/dist/utils/server-instructions/index.d.ts.map +1 -1
- package/dist/utils/server-instructions/index.js +6 -7
- package/dist/utils/server-instructions/index.js.map +1 -1
- package/dist/utils/tools_loader.d.ts.map +1 -1
- package/dist/utils/tools_loader.js +9 -3
- package/dist/utils/tools_loader.js.map +1 -1
- package/dist/web/dist/actor-detail-widget.js +3 -0
- package/dist/web/dist/actor-run-widget.js +219 -216
- package/dist/web/dist/search-actors-widget.js +3 -0
- package/package.json +7 -7
- package/dist/tools/apps/actor_executor.d.ts +0 -8
- package/dist/tools/apps/actor_executor.d.ts.map +0 -1
- package/dist/tools/apps/actor_executor.js +0 -29
- package/dist/tools/apps/actor_executor.js.map +0 -1
- package/dist/tools/core/actor_execution.d.ts +0 -39
- package/dist/tools/core/actor_execution.d.ts.map +0 -1
- package/dist/tools/core/actor_execution.js +0 -135
- package/dist/tools/core/actor_execution.js.map +0 -1
- package/dist/tools/core/actor_response.d.ts +0 -37
- package/dist/tools/core/actor_response.d.ts.map +0 -1
- package/dist/tools/core/actor_response.js +0 -94
- package/dist/tools/core/actor_response.js.map +0 -1
- package/dist/tools/default/actor_executor.d.ts +0 -7
- package/dist/tools/default/actor_executor.d.ts.map +0 -1
- package/dist/tools/default/actor_executor.js +0 -31
- package/dist/tools/default/actor_executor.js.map +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get_actor_run_widget.js","sourceRoot":"","sources":["../../../src/tools/apps/get_actor_run_widget.ts"],"names":[],"mappings":";AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACH,qBAAqB,EACrB,+BAA+B,
|
|
1
|
+
{"version":3,"file":"get_actor_run_widget.js","sourceRoot":"","sources":["../../../src/tools/apps/get_actor_run_widget.ts"],"names":[],"mappings":";AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EACH,qBAAqB,EACrB,+BAA+B,GAClC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SACZ,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,0BAA0B,CAAC;CAC5C,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,gCAAgC,GAAG,MAAM,CAAA;;;;;;;;;;MAUzC,WAAW,CAAC,cAAc;CAC/B,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAc,MAAM,CAAC,MAAM,CAAC;IAC1D,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,WAAW,CAAC,qBAAqB;IACvC,WAAW,EAAE,gCAAgC;IAC7C,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,2BAA2B,CAAoB;IAC3E,YAAY,EAAE,uBAAuB;IACrC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,2BAA2B,CAAC,CAAC;IACvE,eAAe,EAAE,IAAI;IACrB,KAAK,EAAE;QACH,GAAG,MAAA,eAAe,CAAC,WAAW,CAAC,SAAS,CAAC,0CAAE,IAAI;KAClD;IACD,WAAW,EAAE;QACT,KAAK,EAAE,wBAAwB;QAC/B,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,QAAQ,CAAC;QAC7D,MAAM,MAAM,GAAG,2BAA2B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEvD,IAAI,CAAC;YACD,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC;gBACxC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,QAAQ,EAAE,CAAC;gBACX,MAAM;gBACN,YAAY;aACf,CAAC,CAAC;YAEH,oFAAoF;YACpF,8DAA8D;YAC9D,IAAI,SAAS,IAAI,WAAW;gBAAE,OAAO,EAAE,CAAC;YACxC,IAAI,OAAO,IAAI,WAAW;gBAAE,OAAO,WAAW,CAAC,KAAK,CAAC;YAErD,OAAO,+BAA+B,CAAC,EAAE,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACpF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,YAAY,CAAC,KAAK,EAAE,kCAAkC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACjF,OAAO,qBAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACtD,CAAC;IACL,CAAC;CACK,CAAC,CAAC"}
|
|
@@ -12,6 +12,12 @@
|
|
|
12
12
|
* - A plain ToolEntry — mode-independent, always included
|
|
13
13
|
* - A mode map (e.g. { default: ToolEntry, apps: ToolEntry }) — resolver picks entry[mode]
|
|
14
14
|
* - A partial mode map (e.g. { apps: ToolEntry }) — included only for listed modes
|
|
15
|
+
*
|
|
16
|
+
* Apps vs default mode invariant:
|
|
17
|
+
* Only `*-widget` tools differ between modes — they live in `tools/apps/` and render an
|
|
18
|
+
* interactive UI element. All non-widget tools (`call-actor`, `get-actor-run`, direct actor
|
|
19
|
+
* tools, `search-actors`, `fetch-actor-details`) share a single implementation across modes.
|
|
20
|
+
* Do NOT add per-mode runtime variants for non-widget tools.
|
|
15
21
|
*/
|
|
16
22
|
import { HelperTools } from '../const.js';
|
|
17
23
|
import type { ToolEntry } from '../types.js';
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/tools/categories.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/tools/categories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAyCzC;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;CAiCoB,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAkC,CAAC,MAAM,OAAO,cAAc,CAAC,EAAE,CAAC;AAE7F,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAmC,CAAC;AAEtF,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;AAwBnF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,UAA+B,GAAG,eAAe,CAIvF;AAED,eAAO,MAAM,8BAA8B,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,EAG3E,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,WAAW,EAAE,SAAS,CAKlE,CAAC"}
|
package/dist/tools/categories.js
CHANGED
|
@@ -12,6 +12,12 @@
|
|
|
12
12
|
* - A plain ToolEntry — mode-independent, always included
|
|
13
13
|
* - A mode map (e.g. { default: ToolEntry, apps: ToolEntry }) — resolver picks entry[mode]
|
|
14
14
|
* - A partial mode map (e.g. { apps: ToolEntry }) — included only for listed modes
|
|
15
|
+
*
|
|
16
|
+
* Apps vs default mode invariant:
|
|
17
|
+
* Only `*-widget` tools differ between modes — they live in `tools/apps/` and render an
|
|
18
|
+
* interactive UI element. All non-widget tools (`call-actor`, `get-actor-run`, direct actor
|
|
19
|
+
* tools, `search-actors`, `fetch-actor-details`) share a single implementation across modes.
|
|
20
|
+
* Do NOT add per-mode runtime variants for non-widget tools.
|
|
15
21
|
*/
|
|
16
22
|
import { HelperTools } from '../const.js';
|
|
17
23
|
import { ServerMode } from '../types.js';
|
|
@@ -58,7 +64,7 @@ export const toolCategories = {
|
|
|
58
64
|
actors: [
|
|
59
65
|
defaultSearchActors,
|
|
60
66
|
defaultFetchActorDetails,
|
|
61
|
-
// call-actor is
|
|
67
|
+
// call-actor is identical between modes; apps mode appends a widget addendum to the description.
|
|
62
68
|
{ default: defaultCallActor, apps: appsCallActor },
|
|
63
69
|
],
|
|
64
70
|
docs: [
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../src/tools/categories.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../src/tools/categories.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
import type { ActorRun } from 'apify-client';
|
|
2
|
+
import type { ApifyClient } from '../../apify_client.js';
|
|
3
|
+
import { buildMCPResponse } from '../../utils/mcp.js';
|
|
4
|
+
import { type ProgressTracker } from '../../utils/progress.js';
|
|
5
|
+
/** nextStep text for widget-rendered responses: suppresses LLM polling. */
|
|
6
|
+
export declare const WIDGET_NO_POLL_NEXT_STEP = "Widget is rendering live progress. Do NOT poll \u2014 the widget self-updates until completion.";
|
|
7
|
+
/** Maximum value for `waitSecs`. Stays under the 60s tool-call ceiling several MCP clients impose. */
|
|
8
|
+
export declare const WAIT_SECS_MAX = 45;
|
|
9
|
+
/** Default seconds to wait for completion on `call-actor` and direct actor tools. `get-actor-run` also defaults to 30. */
|
|
10
|
+
export declare const CALL_ACTOR_WAIT_SECS_DEFAULT = 30;
|
|
11
|
+
export type RunDataset = {
|
|
12
|
+
id: string;
|
|
13
|
+
name?: string;
|
|
14
|
+
title?: string;
|
|
15
|
+
itemCount?: number;
|
|
16
|
+
cleanItemCount?: number;
|
|
17
|
+
fields?: string[];
|
|
18
|
+
/**
|
|
19
|
+
* JSON Schema fragment for each dataset row. Populated only by direct actor tools (where
|
|
20
|
+
* the target Actor is known at tools/list time, so historical row shape can be looked up
|
|
21
|
+
* via `actorStore`). Absent for `call-actor` / `get-actor-run` (dynamic target).
|
|
22
|
+
*/
|
|
23
|
+
itemsSchema?: {
|
|
24
|
+
type: 'object';
|
|
25
|
+
properties: Record<string, unknown>;
|
|
26
|
+
};
|
|
27
|
+
};
|
|
28
|
+
export type RunKeyValueStore = {
|
|
29
|
+
id: string;
|
|
30
|
+
name?: string;
|
|
31
|
+
title?: string;
|
|
32
|
+
keyCount?: number;
|
|
33
|
+
keys?: string[];
|
|
34
|
+
};
|
|
35
|
+
/**
|
|
36
|
+
* Storage shape mirrors `ActorRunStorageIds` from the Apify client — a map of alias → storage
|
|
37
|
+
* object where `default` is always the primary entry. Using the same plural alias-map structure
|
|
38
|
+
* means named Actor storages (e.g. `storages.datasets.results`) can be added without introducing
|
|
39
|
+
* new field names. Each value extends the bare Apify ID string with fetched metadata.
|
|
40
|
+
*/
|
|
41
|
+
export type RunStorages = {
|
|
42
|
+
datasets?: {
|
|
43
|
+
default: RunDataset;
|
|
44
|
+
[alias: string]: RunDataset;
|
|
45
|
+
};
|
|
46
|
+
keyValueStores?: {
|
|
47
|
+
default: RunKeyValueStore;
|
|
48
|
+
[alias: string]: RunKeyValueStore;
|
|
49
|
+
};
|
|
50
|
+
};
|
|
51
|
+
/**
|
|
52
|
+
* Canonical run response shape returned by `call-actor` and `get-actor-run`.
|
|
53
|
+
* content[0] mirrors structuredContent as JSON (spec compat); content[1] is the
|
|
54
|
+
* LLM-readable summary + nextStep narrative.
|
|
55
|
+
*/
|
|
56
|
+
export type RunResponse = {
|
|
57
|
+
runId: string;
|
|
58
|
+
actorId: string;
|
|
59
|
+
actorName?: string;
|
|
60
|
+
status: string;
|
|
61
|
+
statusMessage?: string;
|
|
62
|
+
exitCode?: number;
|
|
63
|
+
startedAt?: string;
|
|
64
|
+
finishedAt?: string;
|
|
65
|
+
stats?: {
|
|
66
|
+
runTimeSecs?: number;
|
|
67
|
+
computeUnits?: number;
|
|
68
|
+
memMaxBytes?: number;
|
|
69
|
+
};
|
|
70
|
+
storages: RunStorages;
|
|
71
|
+
summary: string;
|
|
72
|
+
nextStep: string;
|
|
73
|
+
};
|
|
74
|
+
export type FetchActorRunResult = {
|
|
75
|
+
run: ActorRun;
|
|
76
|
+
structuredContent: RunResponse;
|
|
77
|
+
};
|
|
78
|
+
/**
|
|
79
|
+
* Build {summary, nextStep} per status. Returns one primary action — never two.
|
|
80
|
+
*/
|
|
81
|
+
export declare function buildStatusSummaryNextStep(params: {
|
|
82
|
+
run: ActorRun;
|
|
83
|
+
dataset?: RunDataset;
|
|
84
|
+
keyValueStore?: RunKeyValueStore;
|
|
85
|
+
}): {
|
|
86
|
+
summary: string;
|
|
87
|
+
nextStep: string;
|
|
88
|
+
};
|
|
89
|
+
/**
|
|
90
|
+
* Build a RunResponse from an already-started ActorRun without waiting.
|
|
91
|
+
* Used when waitSecs=0 (default and apps modes) and by widget variants that return immediately.
|
|
92
|
+
* Storage metadata contains IDs only; pollers/widgets fetch updates via get-actor-run.
|
|
93
|
+
*
|
|
94
|
+
* Pass `widget: true` for widget-rendered responses: nextStep is replaced with a no-poll
|
|
95
|
+
* message and widget _meta is included so the UI renders automatically.
|
|
96
|
+
*
|
|
97
|
+
* Invariant: `widget: true` is only valid from `*-widget` tools. Non-widget tools (call-actor,
|
|
98
|
+
* direct actor tools) must omit it or pass `false`.
|
|
99
|
+
*/
|
|
100
|
+
export declare function buildStartRunResponse(params: {
|
|
101
|
+
actorName: string;
|
|
102
|
+
actorRun: ActorRun;
|
|
103
|
+
widget?: boolean;
|
|
104
|
+
}): ReturnType<typeof buildMCPResponse>;
|
|
105
|
+
/**
|
|
106
|
+
* Default `onAbort` for callers that want the run cancelled when the MCP request is cancelled.
|
|
107
|
+
* Logs and swallows abort failures so a transient API error doesn't override the original
|
|
108
|
+
* cancellation result.
|
|
109
|
+
*/
|
|
110
|
+
export declare const abortRunOnSignal: (runId: string, client: ApifyClient) => Promise<void>;
|
|
111
|
+
export declare function fetchActorRunData(params: {
|
|
112
|
+
runId: string;
|
|
113
|
+
waitSecs?: number;
|
|
114
|
+
actorName?: string;
|
|
115
|
+
client: ApifyClient;
|
|
116
|
+
progressTracker?: ProgressTracker | null;
|
|
117
|
+
abortSignal?: AbortSignal;
|
|
118
|
+
mcpSessionId?: string;
|
|
119
|
+
onAbort?: (runId: string, client: ApifyClient) => Promise<void>;
|
|
120
|
+
}): Promise<{
|
|
121
|
+
error: object;
|
|
122
|
+
} | {
|
|
123
|
+
aborted: true;
|
|
124
|
+
} | {
|
|
125
|
+
result: FetchActorRunResult;
|
|
126
|
+
}>;
|
|
127
|
+
//# sourceMappingURL=actor_run_response.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"actor_run_response.d.ts","sourceRoot":"","sources":["../../../src/tools/core/actor_run_response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAyC,MAAM,cAAc,CAAC;AAIpF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAA0B,KAAK,eAAe,EAAyB,MAAM,yBAAyB,CAAC;AAK9G,2EAA2E;AAC3E,eAAO,MAAM,wBAAwB,oGAA+F,CAAC;AAErI,sGAAsG;AACtG,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,0HAA0H;AAC1H,eAAO,MAAM,4BAA4B,KAAK,CAAC;AA8C/C,MAAM,MAAM,UAAU,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CACzE,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,UAAU,CAAC;QAAC,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAC;IAChE,cAAc,CAAC,EAAE;QAAE,OAAO,EAAE,gBAAgB,CAAC;QAAC,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAAA;KAAE,CAAC;CACrF,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE;QACJ,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,QAAQ,EAAE,WAAW,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,GAAG,EAAE,QAAQ,CAAC;IACd,iBAAiB,EAAE,WAAW,CAAC;CAClC,CAAC;AAkRF;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IAC/C,GAAG,EAAE,QAAQ,CAAC;IACd,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,aAAa,CAAC,EAAE,gBAAgB,CAAC;CACpC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAiDxC;AA4FD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAwCtC;AAMD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAU,OAAO,MAAM,EAAE,QAAQ,WAAW,KAAG,OAAO,CAAC,IAAI,CAIvF,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC,CA6EnF"}
|