@cogitator-ai/mcp 19.8.3 → 19.9.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.
Files changed (79) hide show
  1. package/README.md +130 -8
  2. package/dist/adapter/tool-adapter.d.ts +8 -8
  3. package/dist/adapter/tool-adapter.d.ts.map +1 -1
  4. package/dist/adapter/tool-adapter.js +21 -16
  5. package/dist/adapter/tool-adapter.js.map +1 -1
  6. package/dist/client/input.d.ts +47 -0
  7. package/dist/client/input.d.ts.map +1 -0
  8. package/dist/client/input.js +125 -0
  9. package/dist/client/input.js.map +1 -0
  10. package/dist/client/mcp-client.d.ts +84 -8
  11. package/dist/client/mcp-client.d.ts.map +1 -1
  12. package/dist/client/mcp-client.js +614 -112
  13. package/dist/client/mcp-client.js.map +1 -1
  14. package/dist/client/oauth.d.ts +42 -0
  15. package/dist/client/oauth.d.ts.map +1 -0
  16. package/dist/client/oauth.js +171 -0
  17. package/dist/client/oauth.js.map +1 -0
  18. package/dist/client/param-headers.d.ts +10 -0
  19. package/dist/client/param-headers.d.ts.map +1 -0
  20. package/dist/client/param-headers.js +65 -0
  21. package/dist/client/param-headers.js.map +1 -0
  22. package/dist/client/raw-dispatch.d.ts +40 -0
  23. package/dist/client/raw-dispatch.d.ts.map +1 -0
  24. package/dist/client/raw-dispatch.js +148 -0
  25. package/dist/client/raw-dispatch.js.map +1 -0
  26. package/dist/client/rounds.d.ts +14 -0
  27. package/dist/client/rounds.d.ts.map +1 -0
  28. package/dist/client/rounds.js +33 -0
  29. package/dist/client/rounds.js.map +1 -0
  30. package/dist/client/tasks.d.ts +70 -0
  31. package/dist/client/tasks.d.ts.map +1 -0
  32. package/dist/client/tasks.js +186 -0
  33. package/dist/client/tasks.js.map +1 -0
  34. package/dist/client/transports.d.ts +5 -3
  35. package/dist/client/transports.d.ts.map +1 -1
  36. package/dist/client/transports.js +9 -8
  37. package/dist/client/transports.js.map +1 -1
  38. package/dist/digest.d.ts +8 -0
  39. package/dist/digest.d.ts.map +1 -0
  40. package/dist/digest.js +25 -0
  41. package/dist/digest.js.map +1 -0
  42. package/dist/index.d.ts +7 -3
  43. package/dist/index.d.ts.map +1 -1
  44. package/dist/index.js +6 -2
  45. package/dist/index.js.map +1 -1
  46. package/dist/server/approval.d.ts +17 -5
  47. package/dist/server/approval.d.ts.map +1 -1
  48. package/dist/server/approval.js +26 -12
  49. package/dist/server/approval.js.map +1 -1
  50. package/dist/server/execution.d.ts +134 -0
  51. package/dist/server/execution.d.ts.map +1 -0
  52. package/dist/server/execution.js +185 -0
  53. package/dist/server/execution.js.map +1 -0
  54. package/dist/server/mcp-server.d.ts +45 -19
  55. package/dist/server/mcp-server.d.ts.map +1 -1
  56. package/dist/server/mcp-server.js +551 -120
  57. package/dist/server/mcp-server.js.map +1 -1
  58. package/dist/server/questions.d.ts +19 -2
  59. package/dist/server/questions.d.ts.map +1 -1
  60. package/dist/server/questions.js +38 -21
  61. package/dist/server/questions.js.map +1 -1
  62. package/dist/server/request-state.d.ts +55 -0
  63. package/dist/server/request-state.d.ts.map +1 -0
  64. package/dist/server/request-state.js +66 -0
  65. package/dist/server/request-state.js.map +1 -0
  66. package/dist/server/serve-agents.d.ts.map +1 -1
  67. package/dist/server/serve-agents.js +203 -18
  68. package/dist/server/serve-agents.js.map +1 -1
  69. package/dist/server/tasks.d.ts +75 -0
  70. package/dist/server/tasks.d.ts.map +1 -0
  71. package/dist/server/tasks.js +280 -0
  72. package/dist/server/tasks.js.map +1 -0
  73. package/dist/server/tool-args.d.ts +24 -0
  74. package/dist/server/tool-args.d.ts.map +1 -0
  75. package/dist/server/tool-args.js +58 -0
  76. package/dist/server/tool-args.js.map +1 -0
  77. package/dist/types.d.ts +341 -11
  78. package/dist/types.d.ts.map +1 -1
  79. package/package.json +8 -5
@@ -0,0 +1,280 @@
1
+ /**
2
+ * The server side of MCP tasks (extension io.modelcontextprotocol/tasks, protocol 2026-07-28):
3
+ * a tool call that runs long becomes a task the client polls with `tasks/get`, answers the
4
+ * questions of with `tasks/update` and stops with `tasks/cancel`
5
+ */
6
+ import { randomBytes } from 'node:crypto';
7
+ import { ProtocolError, ProtocolErrorCode } from '@modelcontextprotocol/server';
8
+ export const TASKS_EXTENSION = 'io.modelcontextprotocol/tasks';
9
+ const DEFAULT_TTL_MS = 60 * 60 * 1000;
10
+ const DEFAULT_POLL_INTERVAL_MS = 1000;
11
+ export const DEFAULT_PROMOTE_AFTER_MS = 2000;
12
+ /** Tasks kept in the server's memory, the default {@link MCPTaskStore}, each until its TTL ends */
13
+ export class InMemoryMCPTaskStore {
14
+ records = new Map();
15
+ create(record) {
16
+ this.sweep();
17
+ this.records.set(record.taskId, { ...record });
18
+ return Promise.resolve();
19
+ }
20
+ get(taskId) {
21
+ this.sweep();
22
+ const record = this.records.get(taskId);
23
+ return Promise.resolve(record && { ...record });
24
+ }
25
+ update(taskId, patch) {
26
+ const record = this.records.get(taskId);
27
+ if (!record)
28
+ return Promise.resolve(undefined);
29
+ const next = { ...record, ...patch };
30
+ for (const key of Object.keys(patch)) {
31
+ if (patch[key] === undefined)
32
+ delete next[key];
33
+ }
34
+ this.records.set(taskId, next);
35
+ return Promise.resolve({ ...next });
36
+ }
37
+ delete(taskId) {
38
+ this.records.delete(taskId);
39
+ return Promise.resolve();
40
+ }
41
+ sweep() {
42
+ const now = Date.now();
43
+ for (const [taskId, record] of this.records) {
44
+ if (record.ttlMs !== null && Date.parse(record.createdAt) + record.ttlMs < now) {
45
+ this.records.delete(taskId);
46
+ }
47
+ }
48
+ }
49
+ }
50
+ /** The tasks of one MCP server: their records in the store, their runs in this process */
51
+ export class ServerTasks {
52
+ log;
53
+ questionTimeoutMs;
54
+ store;
55
+ ttlMs;
56
+ pollIntervalMs;
57
+ runners = new Map();
58
+ expiries = new Map();
59
+ constructor(options, log,
60
+ /** How long a question of a task waits for its answer, in ms */
61
+ questionTimeoutMs) {
62
+ this.log = log;
63
+ this.questionTimeoutMs = questionTimeoutMs;
64
+ this.store = options.store ?? new InMemoryMCPTaskStore();
65
+ this.ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
66
+ this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
67
+ }
68
+ /**
69
+ * Makes `execution` a task of `owner` and runs it on: the task is in the store before this
70
+ * resolves with it, as the protocol requires
71
+ */
72
+ async start(owner, execution, restart) {
73
+ const now = new Date().toISOString();
74
+ const record = {
75
+ taskId: randomBytes(16).toString('base64url'),
76
+ status: 'working',
77
+ createdAt: now,
78
+ lastUpdatedAt: now,
79
+ ttlMs: this.ttlMs,
80
+ pollIntervalMs: this.pollIntervalMs,
81
+ owner,
82
+ };
83
+ await this.store.create(record);
84
+ const runner = { execution, waiting: new Map(), cancelled: false };
85
+ this.runners.set(record.taskId, runner);
86
+ const expiry = setTimeout(() => void this.expire(record.taskId), this.ttlMs);
87
+ expiry.unref?.();
88
+ this.expiries.set(record.taskId, expiry);
89
+ void this.run(record.taskId, runner, restart);
90
+ return toWire(record);
91
+ }
92
+ /** The task for `tasks/get`, refused as unknown when it is not `owner`'s */
93
+ async get(taskId, owner) {
94
+ return toWire(await this.owned(taskId, owner));
95
+ }
96
+ /** Delivers answers of `tasks/update`; answers to keys the task does not wait on are ignored */
97
+ async update(taskId, owner, inputResponses) {
98
+ await this.owned(taskId, owner);
99
+ const runner = this.runners.get(taskId);
100
+ if (!runner)
101
+ return;
102
+ for (const [key, answer] of Object.entries(inputResponses)) {
103
+ const deliver = runner.waiting.get(key);
104
+ const parsed = parseElicitResult(answer);
105
+ if (!deliver || !parsed)
106
+ continue;
107
+ runner.waiting.delete(key);
108
+ deliver(parsed);
109
+ }
110
+ }
111
+ /** Stops the task's run (`tasks/cancel`), which ends `cancelled` unless it finished already */
112
+ async cancel(taskId, owner) {
113
+ const record = await this.owned(taskId, owner);
114
+ if (record.status === 'completed' ||
115
+ record.status === 'failed' ||
116
+ record.status === 'cancelled') {
117
+ return;
118
+ }
119
+ const runner = this.runners.get(taskId);
120
+ if (runner) {
121
+ this.stop(runner, new Error('The task was cancelled'));
122
+ this.runners.delete(taskId);
123
+ }
124
+ await this.patch(taskId, { status: 'cancelled', statusMessage: 'Cancelled by the client' });
125
+ }
126
+ /** Stops every run, for a server that stops */
127
+ closeAll() {
128
+ for (const runner of this.runners.values())
129
+ this.stop(runner, new Error('The server stopped'));
130
+ this.runners.clear();
131
+ for (const expiry of this.expiries.values())
132
+ clearTimeout(expiry);
133
+ this.expiries.clear();
134
+ }
135
+ /** Ends a task whose TTL ran out: its run stops and its record goes */
136
+ async expire(taskId) {
137
+ this.expiries.delete(taskId);
138
+ const runner = this.runners.get(taskId);
139
+ if (runner) {
140
+ this.runners.delete(taskId);
141
+ this.stop(runner, new Error('The task expired'));
142
+ }
143
+ await this.store.delete(taskId).catch(() => undefined);
144
+ }
145
+ stop(runner, reason) {
146
+ runner.cancelled = true;
147
+ runner.execution.cancel(reason);
148
+ for (const deliver of runner.waiting.values())
149
+ deliver({ action: 'cancel' });
150
+ runner.waiting.clear();
151
+ }
152
+ async run(taskId, runner, restart) {
153
+ let generation = 0;
154
+ try {
155
+ for (;;) {
156
+ const step = await runner.execution.next();
157
+ if (runner.cancelled)
158
+ return;
159
+ if (step.kind === 'done') {
160
+ if (step.pendingApproval) {
161
+ runner.execution = restart({});
162
+ generation++;
163
+ continue;
164
+ }
165
+ await this.patch(taskId, {
166
+ status: 'completed',
167
+ result: { ...step.result },
168
+ inputRequests: undefined,
169
+ statusMessage: undefined,
170
+ });
171
+ return;
172
+ }
173
+ if (step.kind === 'ask') {
174
+ const key = `${generation}:${step.key}`;
175
+ const [answer] = await this.waitFor(taskId, runner, { [key]: step.request });
176
+ if (runner.cancelled || answer === undefined)
177
+ return;
178
+ runner.execution.respond(step.key, answer.answer);
179
+ await this.patch(taskId, {
180
+ status: 'working',
181
+ inputRequests: undefined,
182
+ statusMessage: undefined,
183
+ });
184
+ continue;
185
+ }
186
+ const prefix = `${generation}:`;
187
+ const requests = Object.fromEntries(Object.entries(step.requests).map(([key, request]) => [`${prefix}${key}`, request]));
188
+ const answers = await this.waitFor(taskId, runner, requests);
189
+ if (runner.cancelled)
190
+ return;
191
+ const responses = Object.fromEntries(answers.map(({ key, answer }) => [key.slice(prefix.length), answer]));
192
+ generation++;
193
+ runner.execution = restart({ input: { responses, state: step.state } });
194
+ await this.patch(taskId, {
195
+ status: 'working',
196
+ inputRequests: undefined,
197
+ statusMessage: undefined,
198
+ });
199
+ }
200
+ }
201
+ catch (error) {
202
+ if (runner.cancelled)
203
+ return;
204
+ const message = error instanceof Error ? error.message : String(error);
205
+ this.log(`Task ${taskId} failed: ${message}`);
206
+ await this.patch(taskId, {
207
+ status: 'failed',
208
+ statusMessage: message,
209
+ error: { code: ProtocolErrorCode.InternalError, message },
210
+ inputRequests: undefined,
211
+ }).catch(() => undefined);
212
+ }
213
+ finally {
214
+ if (this.runners.get(taskId) === runner)
215
+ this.runners.delete(taskId);
216
+ }
217
+ }
218
+ /**
219
+ * Sets the task `input_required` with `requests` and waits for every answer. A question
220
+ * nobody answers within the question timeout counts as dismissed (`cancel`)
221
+ */
222
+ async waitFor(taskId, runner, requests) {
223
+ const answers = Object.keys(requests).map((key) => new Promise((resolve) => {
224
+ runner.waiting.set(key, (answer) => resolve({ key, answer }));
225
+ }));
226
+ const timer = setTimeout(() => {
227
+ this.log(`Nobody answered the questions of task ${taskId} in time`);
228
+ for (const deliver of runner.waiting.values())
229
+ deliver({ action: 'cancel' });
230
+ runner.waiting.clear();
231
+ }, this.questionTimeoutMs());
232
+ timer.unref?.();
233
+ void Promise.all(answers).finally(() => clearTimeout(timer));
234
+ await this.patch(taskId, {
235
+ status: 'input_required',
236
+ statusMessage: 'Waiting for the user to answer',
237
+ inputRequests: Object.fromEntries(Object.entries(requests).map(([key, request]) => [key, toInputRequest(request)])),
238
+ });
239
+ return Promise.all(answers);
240
+ }
241
+ async patch(taskId, patch) {
242
+ await this.store.update(taskId, { ...patch, lastUpdatedAt: new Date().toISOString() });
243
+ }
244
+ async owned(taskId, owner) {
245
+ const record = await this.store.get(taskId);
246
+ if (record?.owner !== owner) {
247
+ throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Unknown task: ${taskId}`);
248
+ }
249
+ return record;
250
+ }
251
+ }
252
+ /** An elicitation form as an input request of a task */
253
+ export function toInputRequest(request) {
254
+ return {
255
+ method: 'elicitation/create',
256
+ params: { mode: 'form', message: request.message, requestedSchema: request.schema },
257
+ };
258
+ }
259
+ function toWire(record) {
260
+ const { owner: _owner, ...task } = record;
261
+ return task;
262
+ }
263
+ /** An answer to an elicitation as a client sends it, undefined for anything else */
264
+ export function parseElicitResult(value) {
265
+ if (typeof value !== 'object' || value === null)
266
+ return undefined;
267
+ const action = value.action;
268
+ if (action === 'decline' || action === 'cancel')
269
+ return { action };
270
+ if (action !== 'accept')
271
+ return undefined;
272
+ const content = value.content;
273
+ return {
274
+ action: 'accept',
275
+ content: typeof content === 'object' && content !== null && !Array.isArray(content)
276
+ ? content
277
+ : {},
278
+ };
279
+ }
280
+ //# sourceMappingURL=tasks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/server/tasks.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * The arguments of a tool call as the client sent them and as the tool's schema parsed them. A
3
+ * call keeps the arguments of its first round across rounds: a schema with a generated default
4
+ * (`z.string().default(() => randomUUID())`) parses to new values on every parse, and the round
5
+ * is known by what the client sent
6
+ */
7
+ import type { StandardSchemaWithJSON } from '@modelcontextprotocol/server';
8
+ import { z } from 'zod';
9
+ /** A call's arguments: `wire` as the client sent them, `parsed` as the tool's schema made them */
10
+ export interface ToolArgs {
11
+ wire: unknown;
12
+ parsed: unknown;
13
+ }
14
+ /**
15
+ * The schema the MCP SDK registers a tool with: it advertises the tool's own schema unchanged
16
+ * and validates with it, handing the handler both the arguments sent and the parsed ones
17
+ */
18
+ export declare function wireArgsSchema(schema: z.ZodType): StandardSchemaWithJSON<unknown, ToolArgs>;
19
+ /**
20
+ * The parsed arguments to keep in the signed state of a round, undefined when they do not
21
+ * survive JSON (a `Date`, a `Map`): such a call parses them anew each round
22
+ */
23
+ export declare function keepableArgs(parsed: unknown): unknown;
24
+ //# sourceMappingURL=tool-args.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-args.d.ts","sourceRoot":"","sources":["../../src/server/tool-args.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,kGAAkG;AAClG,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,sBAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC,CA0B3F;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAUrD"}
@@ -0,0 +1,58 @@
1
+ /**
2
+ * The arguments of a tool call as the client sent them and as the tool's schema parsed them. A
3
+ * call keeps the arguments of its first round across rounds: a schema with a generated default
4
+ * (`z.string().default(() => randomUUID())`) parses to new values on every parse, and the round
5
+ * is known by what the client sent
6
+ */
7
+ import { z } from 'zod';
8
+ import { stableJson } from '../digest.js';
9
+ /**
10
+ * The schema the MCP SDK registers a tool with: it advertises the tool's own schema unchanged
11
+ * and validates with it, handing the handler both the arguments sent and the parsed ones
12
+ */
13
+ export function wireArgsSchema(schema) {
14
+ const standard = schema['~standard'];
15
+ const jsonSchema = (io, target) => {
16
+ const own = standard.jsonSchema;
17
+ if (own)
18
+ return own[io]({ target });
19
+ return z.toJSONSchema(schema, {
20
+ target: target === 'draft-07' || target === 'openapi-3.0' ? target : 'draft-2020-12',
21
+ io,
22
+ });
23
+ };
24
+ return {
25
+ '~standard': {
26
+ version: 1,
27
+ vendor: 'cogitator',
28
+ validate: async (value) => {
29
+ const result = await standard.validate(value);
30
+ return result.issues
31
+ ? { issues: result.issues }
32
+ : { value: { wire: value, parsed: result.value } };
33
+ },
34
+ jsonSchema: {
35
+ input: (options) => jsonSchema('input', options.target),
36
+ output: (options) => jsonSchema('output', options.target),
37
+ },
38
+ },
39
+ };
40
+ }
41
+ /**
42
+ * The parsed arguments to keep in the signed state of a round, undefined when they do not
43
+ * survive JSON (a `Date`, a `Map`): such a call parses them anew each round
44
+ */
45
+ export function keepableArgs(parsed) {
46
+ try {
47
+ const json = JSON.stringify(parsed);
48
+ if (json === undefined)
49
+ return undefined;
50
+ return stableJson(JSON.parse(json)) === stableJson(parsed)
51
+ ? JSON.parse(json)
52
+ : undefined;
53
+ }
54
+ catch {
55
+ return undefined;
56
+ }
57
+ }
58
+ //# sourceMappingURL=tool-args.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-args.js","sourceRoot":"","sources":["../../src/server/tool-args.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAQvC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAiB;IAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,CAAC,EAAsB,EAAE,MAAc,EAA2B,EAAE;QACrF,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC;QAChC,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACpC,OAAO,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE;YAC5B,MAAM,EAAE,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe;YACpF,EAAE;SACH,CAA4B,CAAC;IAChC,CAAC,CAAC;IACF,OAAO;QACL,WAAW,EAAE;YACX,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACxB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC9C,OAAO,MAAM,CAAC,MAAM;oBAClB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;oBAC3B,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;YACvD,CAAC;YACD,UAAU,EAAE;gBACV,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC;gBACvD,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC;aAC1D;SACF;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAe;IAC1C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACzC,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,UAAU,CAAC,MAAM,CAAC;YACxD,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAa;YAC/B,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}