@cogitator-ai/mcp 19.8.3 → 19.9.1
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/README.md +130 -8
- package/dist/adapter/tool-adapter.d.ts +8 -8
- package/dist/adapter/tool-adapter.d.ts.map +1 -1
- package/dist/adapter/tool-adapter.js +21 -16
- package/dist/adapter/tool-adapter.js.map +1 -1
- package/dist/client/input.d.ts +47 -0
- package/dist/client/input.d.ts.map +1 -0
- package/dist/client/input.js +125 -0
- package/dist/client/input.js.map +1 -0
- package/dist/client/mcp-client.d.ts +84 -8
- package/dist/client/mcp-client.d.ts.map +1 -1
- package/dist/client/mcp-client.js +614 -112
- package/dist/client/mcp-client.js.map +1 -1
- package/dist/client/oauth.d.ts +42 -0
- package/dist/client/oauth.d.ts.map +1 -0
- package/dist/client/oauth.js +171 -0
- package/dist/client/oauth.js.map +1 -0
- package/dist/client/param-headers.d.ts +10 -0
- package/dist/client/param-headers.d.ts.map +1 -0
- package/dist/client/param-headers.js +65 -0
- package/dist/client/param-headers.js.map +1 -0
- package/dist/client/raw-dispatch.d.ts +40 -0
- package/dist/client/raw-dispatch.d.ts.map +1 -0
- package/dist/client/raw-dispatch.js +148 -0
- package/dist/client/raw-dispatch.js.map +1 -0
- package/dist/client/rounds.d.ts +14 -0
- package/dist/client/rounds.d.ts.map +1 -0
- package/dist/client/rounds.js +33 -0
- package/dist/client/rounds.js.map +1 -0
- package/dist/client/tasks.d.ts +70 -0
- package/dist/client/tasks.d.ts.map +1 -0
- package/dist/client/tasks.js +186 -0
- package/dist/client/tasks.js.map +1 -0
- package/dist/client/transports.d.ts +5 -3
- package/dist/client/transports.d.ts.map +1 -1
- package/dist/client/transports.js +9 -8
- package/dist/client/transports.js.map +1 -1
- package/dist/digest.d.ts +8 -0
- package/dist/digest.d.ts.map +1 -0
- package/dist/digest.js +25 -0
- package/dist/digest.js.map +1 -0
- package/dist/index.d.ts +7 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +6 -2
- package/dist/index.js.map +1 -1
- package/dist/server/approval.d.ts +17 -5
- package/dist/server/approval.d.ts.map +1 -1
- package/dist/server/approval.js +26 -12
- package/dist/server/approval.js.map +1 -1
- package/dist/server/execution.d.ts +134 -0
- package/dist/server/execution.d.ts.map +1 -0
- package/dist/server/execution.js +185 -0
- package/dist/server/execution.js.map +1 -0
- package/dist/server/mcp-server.d.ts +45 -19
- package/dist/server/mcp-server.d.ts.map +1 -1
- package/dist/server/mcp-server.js +551 -120
- package/dist/server/mcp-server.js.map +1 -1
- package/dist/server/questions.d.ts +19 -2
- package/dist/server/questions.d.ts.map +1 -1
- package/dist/server/questions.js +38 -21
- package/dist/server/questions.js.map +1 -1
- package/dist/server/request-state.d.ts +55 -0
- package/dist/server/request-state.d.ts.map +1 -0
- package/dist/server/request-state.js +66 -0
- package/dist/server/request-state.js.map +1 -0
- package/dist/server/serve-agents.d.ts.map +1 -1
- package/dist/server/serve-agents.js +203 -18
- package/dist/server/serve-agents.js.map +1 -1
- package/dist/server/tasks.d.ts +75 -0
- package/dist/server/tasks.d.ts.map +1 -0
- package/dist/server/tasks.js +280 -0
- package/dist/server/tasks.js.map +1 -0
- package/dist/server/tool-args.d.ts +24 -0
- package/dist/server/tool-args.d.ts.map +1 -0
- package/dist/server/tool-args.js +58 -0
- package/dist/server/tool-args.js.map +1 -0
- package/dist/types.d.ts +341 -11
- package/dist/types.d.ts.map +1 -1
- package/package.json +8 -5
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"raw-dispatch.js","sourceRoot":"","sources":["../../src/client/raw-dispatch.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The rounds a client's paused calls wait on (multi round-trip requests of protocol 2026-07-28)
|
|
3
|
+
*/
|
|
4
|
+
import type { MCPClientRoundRecord, MCPClientRoundStore } from '../types.js';
|
|
5
|
+
export declare const DEFAULT_ROUND_TTL_MS: number;
|
|
6
|
+
/** Rounds kept in the client's memory until they expire, the default {@link MCPClientRoundStore} */
|
|
7
|
+
export declare class InMemoryMCPClientRoundStore implements MCPClientRoundStore {
|
|
8
|
+
private readonly records;
|
|
9
|
+
get(key: string): Promise<MCPClientRoundRecord | undefined>;
|
|
10
|
+
set(key: string, record: MCPClientRoundRecord): Promise<void>;
|
|
11
|
+
delete(key: string): Promise<void>;
|
|
12
|
+
private sweep;
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=rounds.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"rounds.d.ts","sourceRoot":"","sources":["../../src/client/rounds.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE1E,eAAO,MAAM,oBAAoB,QAAiB,CAAC;AAEnD,oGAAoG;AACpG,qBAAa,2BAA4B,YAAW,mBAAmB;IACrE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;IAEnE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;IAM3D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,OAAO,CAAC,KAAK;CAMd"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The rounds a client's paused calls wait on (multi round-trip requests of protocol 2026-07-28)
|
|
3
|
+
*/
|
|
4
|
+
export const DEFAULT_ROUND_TTL_MS = 60 * 60 * 1000;
|
|
5
|
+
/** Rounds kept in the client's memory until they expire, the default {@link MCPClientRoundStore} */
|
|
6
|
+
export class InMemoryMCPClientRoundStore {
|
|
7
|
+
records = new Map();
|
|
8
|
+
get(key) {
|
|
9
|
+
this.sweep();
|
|
10
|
+
const record = this.records.get(key);
|
|
11
|
+
return Promise.resolve(record && copy(record));
|
|
12
|
+
}
|
|
13
|
+
set(key, record) {
|
|
14
|
+
this.sweep();
|
|
15
|
+
this.records.set(key, copy(record));
|
|
16
|
+
return Promise.resolve();
|
|
17
|
+
}
|
|
18
|
+
delete(key) {
|
|
19
|
+
this.records.delete(key);
|
|
20
|
+
return Promise.resolve();
|
|
21
|
+
}
|
|
22
|
+
sweep() {
|
|
23
|
+
const now = Date.now();
|
|
24
|
+
for (const [key, record] of this.records) {
|
|
25
|
+
if (record.expiresAt <= now)
|
|
26
|
+
this.records.delete(key);
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
function copy(record) {
|
|
31
|
+
return { ...record, round: [...record.round], asked: [...record.asked] };
|
|
32
|
+
}
|
|
33
|
+
//# sourceMappingURL=rounds.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"rounds.js","sourceRoot":"","sources":["../../src/client/rounds.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEnD,oGAAoG;AACpG,MAAM,OAAO,2BAA2B;IACrB,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAC;IAEnE,GAAG,CAAC,GAAW;QACb,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,MAA4B;QAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACpC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAEO,KAAK;QACX,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACzC,IAAI,MAAM,CAAC,SAAS,IAAI,GAAG;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;CACF;AAED,SAAS,IAAI,CAAC,MAA4B;IACxC,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC3E,CAAC"}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The client side of MCP tasks (extension io.modelcontextprotocol/tasks, protocol 2026-07-28):
|
|
3
|
+
* a tool call the server answers with a task is polled with `tasks/get` until it ends, its input
|
|
4
|
+
* requests answered with `tasks/update`, and cancelled with `tasks/cancel` when the call is
|
|
5
|
+
*/
|
|
6
|
+
import { z } from 'zod';
|
|
7
|
+
import type { MCPClientTaskRecord, MCPClientTaskStore } from '../types.js';
|
|
8
|
+
import { type InputAnswerer } from './input.js';
|
|
9
|
+
export declare const TASKS_EXTENSION = "io.modelcontextprotocol/tasks";
|
|
10
|
+
export declare const DEFAULT_MAX_POLL_INTERVAL_MS = 30000;
|
|
11
|
+
export declare const TaskSchema: z.ZodObject<{
|
|
12
|
+
taskId: z.ZodString;
|
|
13
|
+
status: z.ZodEnum<{
|
|
14
|
+
input_required: "input_required";
|
|
15
|
+
working: "working";
|
|
16
|
+
completed: "completed";
|
|
17
|
+
failed: "failed";
|
|
18
|
+
cancelled: "cancelled";
|
|
19
|
+
}>;
|
|
20
|
+
statusMessage: z.ZodOptional<z.ZodString>;
|
|
21
|
+
createdAt: z.ZodString;
|
|
22
|
+
lastUpdatedAt: z.ZodString;
|
|
23
|
+
ttlMs: z.ZodNullable<z.ZodNumber>;
|
|
24
|
+
pollIntervalMs: z.ZodOptional<z.ZodNumber>;
|
|
25
|
+
inputRequests: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
26
|
+
result: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
27
|
+
error: z.ZodOptional<z.ZodObject<{
|
|
28
|
+
code: z.ZodNumber;
|
|
29
|
+
message: z.ZodString;
|
|
30
|
+
data: z.ZodOptional<z.ZodUnknown>;
|
|
31
|
+
}, z.core.$loose>>;
|
|
32
|
+
}, z.core.$loose>;
|
|
33
|
+
export type ClientTask = z.output<typeof TaskSchema>;
|
|
34
|
+
/** How a task ended when it did not complete */
|
|
35
|
+
export declare class MCPTaskEndedError extends Error {
|
|
36
|
+
readonly status: 'failed' | 'cancelled';
|
|
37
|
+
readonly taskId: string;
|
|
38
|
+
readonly code?: number;
|
|
39
|
+
constructor(task: ClientTask, toolName: string);
|
|
40
|
+
}
|
|
41
|
+
/** Tasks kept in the client's memory, the default {@link MCPClientTaskStore} */
|
|
42
|
+
export declare class InMemoryMCPClientTaskStore implements MCPClientTaskStore {
|
|
43
|
+
private readonly records;
|
|
44
|
+
get(key: string): Promise<MCPClientTaskRecord | undefined>;
|
|
45
|
+
set(key: string, record: MCPClientTaskRecord): Promise<void>;
|
|
46
|
+
delete(key: string): Promise<void>;
|
|
47
|
+
}
|
|
48
|
+
/** What polling a task needs from the client that started it */
|
|
49
|
+
export interface TaskHost {
|
|
50
|
+
request(method: 'tasks/get' | 'tasks/update' | 'tasks/cancel', params: Record<string, unknown>, signal?: AbortSignal): Promise<Record<string, unknown>>;
|
|
51
|
+
/** Restores a lost connection, so polling the same task goes on */
|
|
52
|
+
restore(error: unknown): Promise<boolean>;
|
|
53
|
+
}
|
|
54
|
+
export interface SettleTaskOptions {
|
|
55
|
+
host: TaskHost;
|
|
56
|
+
toolName: string;
|
|
57
|
+
answerer: InputAnswerer;
|
|
58
|
+
store: MCPClientTaskStore;
|
|
59
|
+
/** The store key of the call, its tool call id, when it has one */
|
|
60
|
+
storeKey?: string;
|
|
61
|
+
maxPollIntervalMs: number;
|
|
62
|
+
signal?: AbortSignal;
|
|
63
|
+
update?: (statusMessage: string) => void;
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* Waits for `task` to end and returns the tool result it completed with. The task is kept in the
|
|
67
|
+
* store under the call's key until then, so the call can come back to it
|
|
68
|
+
*/
|
|
69
|
+
export declare function settleTask(task: ClientTask, options: SettleTaskOptions): Promise<Record<string, unknown>>;
|
|
70
|
+
//# sourceMappingURL=tasks.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/client/tasks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,EAAsC,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAEjF,eAAO,MAAM,eAAe,kCAAkC,CAAC;AAI/D,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;iBAarB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAErD,gDAAgD;AAChD,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM;CAY/C;AAED,gFAAgF;AAChF,qBAAa,0BAA2B,YAAW,kBAAkB;IACnE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAElE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAK1D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAInC;AAED,gEAAgE;AAChE,MAAM,WAAW,QAAQ;IACvB,OAAO,CACL,MAAM,EAAE,WAAW,GAAG,cAAc,GAAG,cAAc,EACrD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpC,mEAAmE;IACnE,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwDlC"}
|
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The client side of MCP tasks (extension io.modelcontextprotocol/tasks, protocol 2026-07-28):
|
|
3
|
+
* a tool call the server answers with a task is polled with `tasks/get` until it ends, its input
|
|
4
|
+
* requests answered with `tasks/update`, and cancelled with `tasks/cancel` when the call is
|
|
5
|
+
*/
|
|
6
|
+
import { z } from 'zod';
|
|
7
|
+
import { answerElicitation, toElicitRequest } from './input.js';
|
|
8
|
+
export const TASKS_EXTENSION = 'io.modelcontextprotocol/tasks';
|
|
9
|
+
const MIN_POLL_INTERVAL_MS = 250;
|
|
10
|
+
const DEFAULT_POLL_INTERVAL_MS = 1000;
|
|
11
|
+
export const DEFAULT_MAX_POLL_INTERVAL_MS = 30_000;
|
|
12
|
+
export const TaskSchema = z.looseObject({
|
|
13
|
+
taskId: z.string().min(1),
|
|
14
|
+
status: z.enum(['working', 'input_required', 'completed', 'failed', 'cancelled']),
|
|
15
|
+
statusMessage: z.string().optional(),
|
|
16
|
+
createdAt: z.string(),
|
|
17
|
+
lastUpdatedAt: z.string(),
|
|
18
|
+
ttlMs: z.number().nullable(),
|
|
19
|
+
pollIntervalMs: z.number().optional(),
|
|
20
|
+
inputRequests: z.record(z.string(), z.unknown()).optional(),
|
|
21
|
+
result: z.record(z.string(), z.unknown()).optional(),
|
|
22
|
+
error: z
|
|
23
|
+
.looseObject({ code: z.number(), message: z.string(), data: z.unknown().optional() })
|
|
24
|
+
.optional(),
|
|
25
|
+
});
|
|
26
|
+
/** How a task ended when it did not complete */
|
|
27
|
+
export class MCPTaskEndedError extends Error {
|
|
28
|
+
status;
|
|
29
|
+
taskId;
|
|
30
|
+
code;
|
|
31
|
+
constructor(task, toolName) {
|
|
32
|
+
const status = task.status === 'failed' ? 'failed' : 'cancelled';
|
|
33
|
+
const why = task.error?.message ?? task.statusMessage;
|
|
34
|
+
super(`The task ${task.taskId} of MCP tool "${toolName}" ${status === 'failed' ? 'failed' : 'was cancelled'}` +
|
|
35
|
+
(why ? `: ${why}` : ''));
|
|
36
|
+
this.name = 'MCPTaskEndedError';
|
|
37
|
+
this.status = status;
|
|
38
|
+
this.taskId = task.taskId;
|
|
39
|
+
if (task.error)
|
|
40
|
+
this.code = task.error.code;
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
/** Tasks kept in the client's memory, the default {@link MCPClientTaskStore} */
|
|
44
|
+
export class InMemoryMCPClientTaskStore {
|
|
45
|
+
records = new Map();
|
|
46
|
+
get(key) {
|
|
47
|
+
const record = this.records.get(key);
|
|
48
|
+
return Promise.resolve(record && { ...record, asked: [...record.asked] });
|
|
49
|
+
}
|
|
50
|
+
set(key, record) {
|
|
51
|
+
this.records.set(key, { ...record, asked: [...record.asked] });
|
|
52
|
+
return Promise.resolve();
|
|
53
|
+
}
|
|
54
|
+
delete(key) {
|
|
55
|
+
this.records.delete(key);
|
|
56
|
+
return Promise.resolve();
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Waits for `task` to end and returns the tool result it completed with. The task is kept in the
|
|
61
|
+
* store under the call's key until then, so the call can come back to it
|
|
62
|
+
*/
|
|
63
|
+
export async function settleTask(task, options) {
|
|
64
|
+
const { host, store, storeKey, answerer, signal } = options;
|
|
65
|
+
const record = {
|
|
66
|
+
taskId: task.taskId,
|
|
67
|
+
tool: options.toolName,
|
|
68
|
+
createdAt: new Date().toISOString(),
|
|
69
|
+
asked: answerer.ledger,
|
|
70
|
+
};
|
|
71
|
+
if (storeKey)
|
|
72
|
+
await store.set(storeKey, record);
|
|
73
|
+
let current = task;
|
|
74
|
+
let lastMessage;
|
|
75
|
+
try {
|
|
76
|
+
for (;;) {
|
|
77
|
+
if (current.statusMessage && current.statusMessage !== lastMessage) {
|
|
78
|
+
lastMessage = current.statusMessage;
|
|
79
|
+
options.update?.(current.statusMessage);
|
|
80
|
+
}
|
|
81
|
+
switch (current.status) {
|
|
82
|
+
case 'completed':
|
|
83
|
+
if (storeKey)
|
|
84
|
+
await store.delete(storeKey);
|
|
85
|
+
return current.result ?? { content: [] };
|
|
86
|
+
case 'failed':
|
|
87
|
+
case 'cancelled':
|
|
88
|
+
if (storeKey)
|
|
89
|
+
await store.delete(storeKey);
|
|
90
|
+
throw new MCPTaskEndedError(current, options.toolName);
|
|
91
|
+
case 'input_required': {
|
|
92
|
+
const responses = await answerTaskInput(current, answerer, async () => {
|
|
93
|
+
if (storeKey)
|
|
94
|
+
await store.set(storeKey, { ...record, asked: [...answerer.ledger] });
|
|
95
|
+
});
|
|
96
|
+
if (Object.keys(responses).length > 0) {
|
|
97
|
+
await withRestore(host, () => host.request('tasks/update', { taskId: current.taskId, inputResponses: responses }, signal));
|
|
98
|
+
}
|
|
99
|
+
break;
|
|
100
|
+
}
|
|
101
|
+
case 'working':
|
|
102
|
+
break;
|
|
103
|
+
}
|
|
104
|
+
await delay(pollInterval(current, options.maxPollIntervalMs), signal);
|
|
105
|
+
current = TaskSchema.parse(await withRestore(host, () => host.request('tasks/get', { taskId: current.taskId }, signal)));
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
catch (error) {
|
|
109
|
+
if (signal?.aborted) {
|
|
110
|
+
await host.request('tasks/cancel', { taskId: current.taskId }).catch(() => undefined);
|
|
111
|
+
if (storeKey)
|
|
112
|
+
await store.delete(storeKey);
|
|
113
|
+
}
|
|
114
|
+
throw error;
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
/**
|
|
118
|
+
* The answers to the outstanding input requests of `task`. The questions the call asked through
|
|
119
|
+
* its run come first, in the order it asked them, so a run that resumed reads its answers in
|
|
120
|
+
* order: those the task no longer waits on are only read
|
|
121
|
+
*/
|
|
122
|
+
async function answerTaskInput(task, answerer, persist) {
|
|
123
|
+
const consumed = answerer.consumed;
|
|
124
|
+
const outstanding = task.inputRequests ?? {};
|
|
125
|
+
for (const [key, value] of Object.entries(outstanding)) {
|
|
126
|
+
if (consumed.has(key) || answerer.ledger.some((entry) => entry.key === key))
|
|
127
|
+
continue;
|
|
128
|
+
const params = z.looseObject({ method: z.string(), params: z.unknown() }).safeParse(value);
|
|
129
|
+
if (!params.success || params.data.method !== 'elicitation/create') {
|
|
130
|
+
consumed.add(key);
|
|
131
|
+
continue;
|
|
132
|
+
}
|
|
133
|
+
answerer.ledger.push({ key, request: toElicitRequest(params.data.params) });
|
|
134
|
+
}
|
|
135
|
+
await persist();
|
|
136
|
+
const responses = {};
|
|
137
|
+
for (const entry of [...answerer.ledger]) {
|
|
138
|
+
if (consumed.has(entry.key))
|
|
139
|
+
continue;
|
|
140
|
+
if (!answerer.interrupt && !(entry.key in outstanding))
|
|
141
|
+
continue;
|
|
142
|
+
const answer = await answerElicitation(entry.request, answerer);
|
|
143
|
+
consumed.add(entry.key);
|
|
144
|
+
if (entry.key in outstanding)
|
|
145
|
+
responses[entry.key] = answer;
|
|
146
|
+
}
|
|
147
|
+
return responses;
|
|
148
|
+
}
|
|
149
|
+
async function withRestore(host, operation) {
|
|
150
|
+
try {
|
|
151
|
+
return await operation();
|
|
152
|
+
}
|
|
153
|
+
catch (error) {
|
|
154
|
+
if (await host.restore(error))
|
|
155
|
+
return operation();
|
|
156
|
+
throw error;
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
function pollInterval(task, max) {
|
|
160
|
+
const suggested = task.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
|
|
161
|
+
return Math.min(Math.max(suggested, MIN_POLL_INTERVAL_MS), max);
|
|
162
|
+
}
|
|
163
|
+
function delay(ms, signal) {
|
|
164
|
+
return new Promise((resolve, reject) => {
|
|
165
|
+
if (signal?.aborted) {
|
|
166
|
+
reject(abortReason(signal));
|
|
167
|
+
return;
|
|
168
|
+
}
|
|
169
|
+
const timer = setTimeout(() => {
|
|
170
|
+
signal?.removeEventListener('abort', onAbort);
|
|
171
|
+
resolve();
|
|
172
|
+
}, ms);
|
|
173
|
+
const onAbort = () => {
|
|
174
|
+
clearTimeout(timer);
|
|
175
|
+
reject(abortReason(signal));
|
|
176
|
+
};
|
|
177
|
+
signal?.addEventListener('abort', onAbort, { once: true });
|
|
178
|
+
});
|
|
179
|
+
}
|
|
180
|
+
function abortReason(signal) {
|
|
181
|
+
const reason = signal?.reason;
|
|
182
|
+
return reason instanceof Error
|
|
183
|
+
? reason
|
|
184
|
+
: new DOMException('The operation was aborted', 'AbortError');
|
|
185
|
+
}
|
|
186
|
+
//# sourceMappingURL=tasks.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/client/tasks.ts"],"names":[],"mappings":"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"}
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
*
|
|
4
4
|
* Provides factory functions for creating MCP transports.
|
|
5
5
|
*/
|
|
6
|
-
import type
|
|
6
|
+
import { SSEClientTransport, StreamableHTTPClientTransport, type OAuthClientProvider, type Transport } from '@modelcontextprotocol/client';
|
|
7
7
|
export interface StdioTransportConfig {
|
|
8
8
|
/** Command to execute */
|
|
9
9
|
command: string;
|
|
@@ -19,6 +19,8 @@ export interface HttpTransportConfig {
|
|
|
19
19
|
url: string;
|
|
20
20
|
/** Custom headers */
|
|
21
21
|
headers?: Record<string, string>;
|
|
22
|
+
/** OAuth for a server that asks for it */
|
|
23
|
+
authProvider?: OAuthClientProvider;
|
|
22
24
|
}
|
|
23
25
|
/**
|
|
24
26
|
* Create a stdio transport for connecting to a local MCP server process
|
|
@@ -42,7 +44,7 @@ export declare function createStdioTransport(config: StdioTransportConfig): Tran
|
|
|
42
44
|
* });
|
|
43
45
|
* ```
|
|
44
46
|
*/
|
|
45
|
-
export declare function createHttpTransport(config: HttpTransportConfig):
|
|
47
|
+
export declare function createHttpTransport(config: HttpTransportConfig): StreamableHTTPClientTransport;
|
|
46
48
|
/**
|
|
47
49
|
* Create an SSE transport for a server of the older HTTP+SSE protocol: a GET opens the event
|
|
48
50
|
* stream, messages go in POSTs to the endpoint the server names. `headers` go with both
|
|
@@ -52,5 +54,5 @@ export declare function createHttpTransport(config: HttpTransportConfig): Transp
|
|
|
52
54
|
* const transport = createSseTransport({ url: 'http://localhost:3000/sse' });
|
|
53
55
|
* ```
|
|
54
56
|
*/
|
|
55
|
-
export declare function createSseTransport(config: HttpTransportConfig):
|
|
57
|
+
export declare function createSseTransport(config: HttpTransportConfig): SSEClientTransport;
|
|
56
58
|
//# sourceMappingURL=transports.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"transports.d.ts","sourceRoot":"","sources":["../../src/client/transports.ts"],"names":[],"mappings":"AAAA;;;;GAIG;
|
|
1
|
+
{"version":3,"file":"transports.d.ts","sourceRoot":"","sources":["../../src/client/transports.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACf,MAAM,8BAA8B,CAAC;AAGtC,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IAEZ,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,0CAA0C;IAC1C,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,CAiB5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,6BAA6B,CAK9F;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,kBAAkB,CAKlF"}
|
|
@@ -3,9 +3,8 @@
|
|
|
3
3
|
*
|
|
4
4
|
* Provides factory functions for creating MCP transports.
|
|
5
5
|
*/
|
|
6
|
-
import { SSEClientTransport } from '@modelcontextprotocol/
|
|
7
|
-
import { StdioClientTransport } from '@modelcontextprotocol/
|
|
8
|
-
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
|
|
6
|
+
import { SSEClientTransport, StreamableHTTPClientTransport, } from '@modelcontextprotocol/client';
|
|
7
|
+
import { StdioClientTransport } from '@modelcontextprotocol/client/stdio';
|
|
9
8
|
/**
|
|
10
9
|
* Create a stdio transport for connecting to a local MCP server process
|
|
11
10
|
*
|
|
@@ -29,9 +28,9 @@ export function createStdioTransport(config) {
|
|
|
29
28
|
}
|
|
30
29
|
return new StdioClientTransport({
|
|
31
30
|
command: config.command,
|
|
32
|
-
args: config.args,
|
|
33
|
-
env,
|
|
34
|
-
cwd: config.cwd,
|
|
31
|
+
...(config.args && { args: config.args }),
|
|
32
|
+
...(env && { env }),
|
|
33
|
+
...(config.cwd && { cwd: config.cwd }),
|
|
35
34
|
});
|
|
36
35
|
}
|
|
37
36
|
/**
|
|
@@ -46,7 +45,8 @@ export function createStdioTransport(config) {
|
|
|
46
45
|
*/
|
|
47
46
|
export function createHttpTransport(config) {
|
|
48
47
|
return new StreamableHTTPClientTransport(new URL(config.url), {
|
|
49
|
-
|
|
48
|
+
...(config.headers && { requestInit: { headers: config.headers } }),
|
|
49
|
+
...(config.authProvider && { authProvider: config.authProvider }),
|
|
50
50
|
});
|
|
51
51
|
}
|
|
52
52
|
/**
|
|
@@ -60,7 +60,8 @@ export function createHttpTransport(config) {
|
|
|
60
60
|
*/
|
|
61
61
|
export function createSseTransport(config) {
|
|
62
62
|
return new SSEClientTransport(new URL(config.url), {
|
|
63
|
-
|
|
63
|
+
...(config.headers && { requestInit: { headers: config.headers } }),
|
|
64
|
+
...(config.authProvider && { authProvider: config.authProvider }),
|
|
64
65
|
});
|
|
65
66
|
}
|
|
66
67
|
//# sourceMappingURL=transports.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"transports.js","sourceRoot":"","sources":["../../src/client/transports.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,
|
|
1
|
+
{"version":3,"file":"transports.js","sourceRoot":"","sources":["../../src/client/transports.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,6BAA6B,GAG9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AA2B1E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA4B;IAC/D,IAAI,GAAuC,CAAC;IAC5C,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;QACxB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;gBACzC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,oBAAoB,CAAC;QAC9B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACzC,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,CAAC;QACnB,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;KACvC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA2B;IAC7D,OAAO,IAAI,6BAA6B,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;QAC5D,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QACnE,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;KAClE,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA2B;IAC5D,OAAO,IAAI,kBAAkB,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;QACjD,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QACnE,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;KAClE,CAAC,CAAC;AACL,CAAC"}
|
package/dist/digest.d.ts
ADDED
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The digest a tool call is known by across rounds: its tool and its arguments, keys in order
|
|
3
|
+
*/
|
|
4
|
+
/** A digest of a call: its tool and its arguments, keys in order */
|
|
5
|
+
export declare function callDigest(tool: string, args: unknown): string;
|
|
6
|
+
/** JSON of `value` with object keys in order, the same for equal values */
|
|
7
|
+
export declare function stableJson(value: unknown): string;
|
|
8
|
+
//# sourceMappingURL=digest.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../src/digest.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAM9D;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASjD"}
|
package/dist/digest.js
ADDED
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The digest a tool call is known by across rounds: its tool and its arguments, keys in order
|
|
3
|
+
*/
|
|
4
|
+
import { createHash } from 'node:crypto';
|
|
5
|
+
/** A digest of a call: its tool and its arguments, keys in order */
|
|
6
|
+
export function callDigest(tool, args) {
|
|
7
|
+
return createHash('sha256')
|
|
8
|
+
.update(tool)
|
|
9
|
+
.update('\0')
|
|
10
|
+
.update(stableJson(args))
|
|
11
|
+
.digest('base64url');
|
|
12
|
+
}
|
|
13
|
+
/** JSON of `value` with object keys in order, the same for equal values */
|
|
14
|
+
export function stableJson(value) {
|
|
15
|
+
if (Array.isArray(value))
|
|
16
|
+
return `[${value.map(stableJson).join(',')}]`;
|
|
17
|
+
if (typeof value === 'object' && value !== null) {
|
|
18
|
+
const entries = Object.entries(value)
|
|
19
|
+
.filter(([, entry]) => entry !== undefined)
|
|
20
|
+
.sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
|
|
21
|
+
return `{${entries.map(([key, entry]) => `${JSON.stringify(key)}:${stableJson(entry)}`).join(',')}}`;
|
|
22
|
+
}
|
|
23
|
+
return JSON.stringify(value) ?? 'null';
|
|
24
|
+
}
|
|
25
|
+
//# sourceMappingURL=digest.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"digest.js","sourceRoot":"","sources":["../src/digest.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,oEAAoE;AACpE,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,IAAa;IACpD,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,IAAI,CAAC;SACZ,MAAM,CAAC,IAAI,CAAC;SACZ,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;SACxB,MAAM,CAAC,WAAW,CAAC,CAAC;AACzB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACxE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;aAClC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;aAC1C,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACvG,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC;AACzC,CAAC"}
|
package/dist/index.d.ts
CHANGED
|
@@ -2,17 +2,21 @@
|
|
|
2
2
|
* @cogitator-ai/mcp - MCP (Model Context Protocol) Integration
|
|
3
3
|
*
|
|
4
4
|
* This package provides full MCP support for Cogitator:
|
|
5
|
-
* - MCPClient: Connect to external MCP servers and use their tools
|
|
5
|
+
* - MCPClient: Connect to external MCP servers and use their tools (protocol 2026-07-28 and 2025-11-25)
|
|
6
6
|
* - MCPServer: Expose Cogitator tools as an MCP server
|
|
7
7
|
* - Tool Adapter: Convert between Cogitator and MCP tool formats
|
|
8
8
|
*/
|
|
9
9
|
export { MCPClient, MCPToolError, MCPToolInterruptedError, connectMCPServer, } from './client/mcp-client.js';
|
|
10
|
+
export { MCPTaskEndedError, InMemoryMCPClientTaskStore } from './client/tasks.js';
|
|
11
|
+
export { InMemoryMCPClientRoundStore } from './client/rounds.js';
|
|
12
|
+
export { createMCPOAuthProvider, InMemoryMCPOAuthStore, type MCPOAuthProvider, type MCPOAuthProviderOptions, } from './client/oauth.js';
|
|
10
13
|
export { createStdioTransport, createHttpTransport, createSseTransport } from './client/transports.js';
|
|
11
14
|
export { experimental_mcpConnector, mcpClientConfigOf, type McpConnectorOptions, } from './client/connector.js';
|
|
12
15
|
export type { StdioTransportConfig, HttpTransportConfig } from './client/transports.js';
|
|
13
16
|
export { MCPServer, serveMCPTools } from './server/mcp-server.js';
|
|
17
|
+
export { InMemoryMCPTaskStore } from './server/tasks.js';
|
|
14
18
|
export { serveAgents, agentTools } from './server/serve-agents.js';
|
|
15
19
|
export type { AgentHost, AgentToolAnswer, AgentToolsOptions, ServeAgentsConfig, } from './server/serve-agents.js';
|
|
16
|
-
export { cogitatorToMCP, toolSchemaToMCP, mcpToCogitator, wrapMCPTools, normalizeMCPToolName, isDestructiveMCPTool, zodToJsonSchema, jsonSchemaToZod, resultToMCPContent, mcpContentToResult, } from './adapter/tool-adapter.js';
|
|
17
|
-
export type { MCPClientConfig, MCPCallToolOptions, MCPRetryConfig, MCPServerConfig, MCPCaller, MCPAuthFunction, MCPToolContext, MCPElicitRequest, MCPElicitResult, MCPElicitField, MCPElicitOption, MCPElicitMultiSelect, MCPTransportType, MCPClientTransportType, MCPResource, MCPResourceContent, MCPResourceReadContent, MCPResourceConfig, MCPPrompt, MCPPromptArgument, MCPPromptArgumentConfig, MCPPromptMessage, MCPPromptReplyMessage, MCPPromptConfig, MCPPromptResult, MCPToolDefinition, MCPObjectSchema, MCPToolAnnotations, MCPToolCallResult, MCPToolContent, ToolAdapterOptions, } from './types.js';
|
|
20
|
+
export { cogitatorToMCP, toolSchemaToMCP, mcpToCogitator, wrapMCPTools, normalizeMCPToolName, isDestructiveMCPTool, zodToJsonSchema, jsonSchemaToZod, jsonSchemaValueToZod, resultToMCPContent, mcpContentToResult, } from './adapter/tool-adapter.js';
|
|
21
|
+
export type { MCPClientConfig, MCPCallToolOptions, MCPRetryConfig, MCPServerConfig, MCPCaller, MCPAuthFunction, MCPToolContext, MCPElicitRequest, MCPElicitResult, MCPElicitField, MCPElicitOption, MCPElicitMultiSelect, MCPTransportType, MCPClientTransportType, MCPResource, MCPResourceContent, MCPResourceReadContent, MCPResourceConfig, MCPPrompt, MCPPromptArgument, MCPPromptArgumentConfig, MCPPromptMessage, MCPPromptReplyMessage, MCPPromptConfig, MCPPromptResult, MCPToolDefinition, MCPObjectSchema, MCPToolAnnotations, MCPToolCallResult, MCPToolContent, MCPJsonSchema, MCPProtocolMode, MCPProtocolEra, MCPElicitUrlRequest, MCPElicitationHandler, MCPElicitationSource, MCPClientTaskOptions, MCPClientTaskRecord, MCPClientTaskStore, MCPAskedInput, MCPClientRoundRecord, MCPClientRoundStore, MCPClientRoundOptions, MCPOAuthConfig, MCPOAuthStore, MCPSubscription, MCPSubscriptionFilter, MCPSubscriptionHandlers, MCPServerDiscovery, MCPToolInput, MCPInputPending, MCPServerTaskOptions, MCPProtectedResourceConfig, MCPTaskStatus, MCPTaskRecord, MCPTaskInputRequest, MCPTaskStore, ToolAdapterOptions, } from './types.js';
|
|
18
22
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,SAAS,EACT,YAAY,EACZ,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAErF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EACV,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,SAAS,EACT,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,MAAM,SAAS,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,SAAS,EACT,YAAY,EACZ,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAErF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EACV,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,SAAS,EACT,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,GACnB,MAAM,SAAS,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -2,14 +2,18 @@
|
|
|
2
2
|
* @cogitator-ai/mcp - MCP (Model Context Protocol) Integration
|
|
3
3
|
*
|
|
4
4
|
* This package provides full MCP support for Cogitator:
|
|
5
|
-
* - MCPClient: Connect to external MCP servers and use their tools
|
|
5
|
+
* - MCPClient: Connect to external MCP servers and use their tools (protocol 2026-07-28 and 2025-11-25)
|
|
6
6
|
* - MCPServer: Expose Cogitator tools as an MCP server
|
|
7
7
|
* - Tool Adapter: Convert between Cogitator and MCP tool formats
|
|
8
8
|
*/
|
|
9
9
|
export { MCPClient, MCPToolError, MCPToolInterruptedError, connectMCPServer, } from './client/mcp-client.js';
|
|
10
|
+
export { MCPTaskEndedError, InMemoryMCPClientTaskStore } from './client/tasks.js';
|
|
11
|
+
export { InMemoryMCPClientRoundStore } from './client/rounds.js';
|
|
12
|
+
export { createMCPOAuthProvider, InMemoryMCPOAuthStore, } from './client/oauth.js';
|
|
10
13
|
export { createStdioTransport, createHttpTransport, createSseTransport } from './client/transports.js';
|
|
11
14
|
export { experimental_mcpConnector, mcpClientConfigOf, } from './client/connector.js';
|
|
12
15
|
export { MCPServer, serveMCPTools } from './server/mcp-server.js';
|
|
16
|
+
export { InMemoryMCPTaskStore } from './server/tasks.js';
|
|
13
17
|
export { serveAgents, agentTools } from './server/serve-agents.js';
|
|
14
|
-
export { cogitatorToMCP, toolSchemaToMCP, mcpToCogitator, wrapMCPTools, normalizeMCPToolName, isDestructiveMCPTool, zodToJsonSchema, jsonSchemaToZod, resultToMCPContent, mcpContentToResult, } from './adapter/tool-adapter.js';
|
|
18
|
+
export { cogitatorToMCP, toolSchemaToMCP, mcpToCogitator, wrapMCPTools, normalizeMCPToolName, isDestructiveMCPTool, zodToJsonSchema, jsonSchemaToZod, jsonSchemaValueToZod, resultToMCPContent, mcpContentToResult, } from './adapter/tool-adapter.js';
|
|
15
19
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,SAAS,EACT,YAAY,EACZ,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EACL,yBAAyB,EACzB,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAQhE,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,SAAS,EACT,YAAY,EACZ,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GAGtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EACL,yBAAyB,EACzB,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAQhE,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC"}
|
|
@@ -1,11 +1,23 @@
|
|
|
1
1
|
import type { ToolApprovalDecision, ToolApprovalRequest } from '@cogitator-ai/types';
|
|
2
|
-
import type { MCPToolContext } from '../types.js';
|
|
2
|
+
import type { MCPElicitRequest, MCPElicitResult, MCPToolContext } from '../types.js';
|
|
3
|
+
/**
|
|
4
|
+
* The elicitation form that asks whether a tool call that needs approval may run: it says why
|
|
5
|
+
* the call asks, and with `allowRemember`, when the call suggests a rule, offers to allow calls
|
|
6
|
+
* like it from now on
|
|
7
|
+
*/
|
|
8
|
+
export declare function approvalForm(request: ToolApprovalRequest, options?: {
|
|
9
|
+
allowRemember?: boolean;
|
|
10
|
+
}): MCPElicitRequest;
|
|
11
|
+
/**
|
|
12
|
+
* The decision an answer to {@link approvalForm} makes. `offersAlways`: whether the form offered
|
|
13
|
+
* to allow calls like it for good
|
|
14
|
+
*/
|
|
15
|
+
export declare function approvalDecision(reply: MCPElicitResult, offersAlways?: boolean): ToolApprovalDecision;
|
|
3
16
|
/**
|
|
4
17
|
* Ask the person at the MCP client whether a tool call that needs approval may run, through
|
|
5
|
-
* elicitation
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
* the caller decides what an unanswered call means.
|
|
18
|
+
* elicitation (see {@link approvalForm}). `undefined` when nobody can be asked (the client does
|
|
19
|
+
* not support elicitation, or the transport cannot carry it), so the caller decides what an
|
|
20
|
+
* unanswered call means.
|
|
9
21
|
*/
|
|
10
22
|
export declare function elicitApproval(elicit: MCPToolContext['elicit'], request: ToolApprovalRequest, options?: {
|
|
11
23
|
allowRemember?: boolean;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../src/server/approval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../src/server/approval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAElF;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,gBAAgB,CAqBlB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,eAAe,EACtB,YAAY,UAAQ,GACnB,oBAAoB,CAOtB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,EAChC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAQ3C"}
|