@fabric-harness/sdk 0.1.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 (107) hide show
  1. package/LICENSE +202 -0
  2. package/README.md +73 -0
  3. package/dist/agent-definition.d.ts +61 -0
  4. package/dist/agent-definition.d.ts.map +1 -0
  5. package/dist/agent-definition.js +52 -0
  6. package/dist/agent-definition.js.map +1 -0
  7. package/dist/agent.d.ts +13 -0
  8. package/dist/agent.d.ts.map +1 -0
  9. package/dist/agent.js +99 -0
  10. package/dist/agent.js.map +1 -0
  11. package/dist/context-budget.d.ts +20 -0
  12. package/dist/context-budget.d.ts.map +1 -0
  13. package/dist/context-budget.js +27 -0
  14. package/dist/context-budget.js.map +1 -0
  15. package/dist/context.d.ts +3 -0
  16. package/dist/context.d.ts.map +1 -0
  17. package/dist/context.js +8 -0
  18. package/dist/context.js.map +1 -0
  19. package/dist/error.d.ts +25 -0
  20. package/dist/error.d.ts.map +1 -0
  21. package/dist/error.js +48 -0
  22. package/dist/error.js.map +1 -0
  23. package/dist/filesystem-source.d.ts +69 -0
  24. package/dist/filesystem-source.d.ts.map +1 -0
  25. package/dist/filesystem-source.js +109 -0
  26. package/dist/filesystem-source.js.map +1 -0
  27. package/dist/history.d.ts +16 -0
  28. package/dist/history.d.ts.map +1 -0
  29. package/dist/history.js +118 -0
  30. package/dist/history.js.map +1 -0
  31. package/dist/index.d.ts +44 -0
  32. package/dist/index.d.ts.map +1 -0
  33. package/dist/index.js +25 -0
  34. package/dist/index.js.map +1 -0
  35. package/dist/lite.d.ts +46 -0
  36. package/dist/lite.d.ts.map +1 -0
  37. package/dist/lite.js +38 -0
  38. package/dist/lite.js.map +1 -0
  39. package/dist/loop.d.ts +41 -0
  40. package/dist/loop.d.ts.map +1 -0
  41. package/dist/loop.js +94 -0
  42. package/dist/loop.js.map +1 -0
  43. package/dist/mcp-stdio.d.ts +28 -0
  44. package/dist/mcp-stdio.d.ts.map +1 -0
  45. package/dist/mcp-stdio.js +102 -0
  46. package/dist/mcp-stdio.js.map +1 -0
  47. package/dist/mcp.d.ts +40 -0
  48. package/dist/mcp.d.ts.map +1 -0
  49. package/dist/mcp.js +153 -0
  50. package/dist/mcp.js.map +1 -0
  51. package/dist/model.d.ts +204 -0
  52. package/dist/model.d.ts.map +1 -0
  53. package/dist/model.js +661 -0
  54. package/dist/model.js.map +1 -0
  55. package/dist/otel.d.ts +17 -0
  56. package/dist/otel.d.ts.map +1 -0
  57. package/dist/otel.js +25 -0
  58. package/dist/otel.js.map +1 -0
  59. package/dist/policy.d.ts +54 -0
  60. package/dist/policy.d.ts.map +1 -0
  61. package/dist/policy.js +148 -0
  62. package/dist/policy.js.map +1 -0
  63. package/dist/providers.d.ts +37 -0
  64. package/dist/providers.d.ts.map +1 -0
  65. package/dist/providers.js +265 -0
  66. package/dist/providers.js.map +1 -0
  67. package/dist/redaction.d.ts +11 -0
  68. package/dist/redaction.d.ts.map +1 -0
  69. package/dist/redaction.js +41 -0
  70. package/dist/redaction.js.map +1 -0
  71. package/dist/result.d.ts +7 -0
  72. package/dist/result.d.ts.map +1 -0
  73. package/dist/result.js +105 -0
  74. package/dist/result.js.map +1 -0
  75. package/dist/runtime-mode.d.ts +30 -0
  76. package/dist/runtime-mode.d.ts.map +1 -0
  77. package/dist/runtime-mode.js +42 -0
  78. package/dist/runtime-mode.js.map +1 -0
  79. package/dist/sandbox.d.ts +247 -0
  80. package/dist/sandbox.d.ts.map +1 -0
  81. package/dist/sandbox.js +922 -0
  82. package/dist/sandbox.js.map +1 -0
  83. package/dist/schema.d.ts +37 -0
  84. package/dist/schema.d.ts.map +1 -0
  85. package/dist/schema.js +121 -0
  86. package/dist/schema.js.map +1 -0
  87. package/dist/session.d.ts +60 -0
  88. package/dist/session.d.ts.map +1 -0
  89. package/dist/session.js +762 -0
  90. package/dist/session.js.map +1 -0
  91. package/dist/store.d.ts +48 -0
  92. package/dist/store.d.ts.map +1 -0
  93. package/dist/store.js +348 -0
  94. package/dist/store.js.map +1 -0
  95. package/dist/telemetry.d.ts +15 -0
  96. package/dist/telemetry.d.ts.map +1 -0
  97. package/dist/telemetry.js +51 -0
  98. package/dist/telemetry.js.map +1 -0
  99. package/dist/tools.d.ts +131 -0
  100. package/dist/tools.d.ts.map +1 -0
  101. package/dist/tools.js +235 -0
  102. package/dist/tools.js.map +1 -0
  103. package/dist/types.d.ts +343 -0
  104. package/dist/types.d.ts.map +1 -0
  105. package/dist/types.js +2 -0
  106. package/dist/types.js.map +1 -0
  107. package/package.json +71 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAqB,YAAY,EAAE,aAAa,EAAgC,UAAU,EAAE,MAAM,YAAY,CAAC;AAC3H,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG1F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5B,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,CAAC,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACtH,WAAW,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9E,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,qBAAa,iBAAkB,YAAW,gBAAgB;IACxD,QAAQ,CAAC,IAAI,YAAY;IAEnB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;YA0DlD,qBAAqB;CAkBpC;AAYD,eAAO,MAAM,kBAAkB,mBAA0B,CAAC"}
package/dist/loop.js ADDED
@@ -0,0 +1,94 @@
1
+ import { FabricError } from './error.js';
2
+ import { defaultModelProvider, generateWithRuntime, toolsToModelSchemas } from './model.js';
3
+ import { isContextOverflowError } from './context-budget.js';
4
+ export class NativeLoopRuntime {
5
+ name = 'native';
6
+ async runPrompt(input) {
7
+ if (input.toolCalls?.length) {
8
+ const results = await input.executeToolCalls(input.toolCalls, input.policy, input.approvalTimeoutMs);
9
+ await input.recordEntry('result', { result: results });
10
+ await input.emit('prompt_end', { text: input.text, result: results });
11
+ return { text: JSON.stringify(results), raw: results };
12
+ }
13
+ const provider = input.modelProvider ?? defaultModelProvider;
14
+ const maxIterations = input.maxIterations ?? 8;
15
+ let latestUsage;
16
+ for (let iteration = 0; iteration < maxIterations; iteration += 1) {
17
+ const request = {
18
+ messages: input.messages,
19
+ tools: toolsToModelSchemas(input.tools.values()),
20
+ ...(input.model !== undefined ? { model: input.model } : {}),
21
+ };
22
+ let response;
23
+ try {
24
+ response = await generateWithRuntime(provider, request, {
25
+ ...(input.modelTimeoutMs !== undefined ? { timeoutMs: input.modelTimeoutMs } : {}),
26
+ ...(input.modelRetries !== undefined ? { retries: input.modelRetries } : {}),
27
+ ...(input.modelRetryDelayMs !== undefined ? { retryDelayMs: input.modelRetryDelayMs } : {}),
28
+ ...(input.signal !== undefined ? { signal: input.signal } : {}),
29
+ onAttempt: async (event) => {
30
+ await input.recordEntry('model_attempt', event);
31
+ await input.emit('model_attempt', event);
32
+ },
33
+ });
34
+ }
35
+ catch (error) {
36
+ throw mapModelError(error);
37
+ }
38
+ if (response.usage) {
39
+ latestUsage = response.usage;
40
+ await input.recordEntry('model_attempt', { usage: response.usage });
41
+ await input.emit('result', { usage: response.usage });
42
+ }
43
+ if (response.toolCalls?.length) {
44
+ await this.executeModelToolCalls(response.toolCalls, input);
45
+ continue;
46
+ }
47
+ const finalText = response.message?.content ?? '';
48
+ input.messages.push({ role: 'assistant', content: finalText });
49
+ await input.recordEntry('assistant_message', { text: finalText });
50
+ // Emit a text_delta event so stream() consumers receive the final text
51
+ if (finalText)
52
+ await input.emit('text_delta', { delta: finalText });
53
+ await input.recordEntry('result', { result: finalText });
54
+ await input.emit('prompt_end', { text: input.text, result: finalText });
55
+ return { text: finalText, raw: finalText, ...(latestUsage ? { usage: latestUsage } : {}) };
56
+ }
57
+ throw new FabricError({ code: 'MODEL_CONTEXT_OVERFLOW', message: `Prompt exceeded maxIterations (${maxIterations}) without a final response.`, retryable: true });
58
+ }
59
+ async executeModelToolCalls(calls, input) {
60
+ // Push the assistant message with tool calls so the model sees the full round-trip
61
+ input.messages.push({ role: 'assistant', content: '', toolCalls: calls });
62
+ const results = await input.executeToolCalls(calls.map((call) => ({ tool: call.name, input: call.input, id: call.id })), undefined, input.approvalTimeoutMs);
63
+ for (let i = 0; i < results.length; i += 1) {
64
+ const result = results[i];
65
+ const callId = i < calls.length ? calls[i]?.id : undefined;
66
+ if (!result)
67
+ continue;
68
+ const message = {
69
+ role: 'tool',
70
+ name: result.tool,
71
+ content: result.error ?? JSON.stringify(result.output ?? null),
72
+ };
73
+ if (callId !== undefined)
74
+ message.toolCallId = callId;
75
+ input.messages.push(message);
76
+ }
77
+ }
78
+ }
79
+ function mapModelError(error) {
80
+ if (error instanceof FabricError)
81
+ return error;
82
+ const message = error instanceof Error ? error.message : String(error);
83
+ if (isContextOverflowError(error))
84
+ return new FabricError({ code: 'MODEL_CONTEXT_OVERFLOW', message, cause: error, retryable: true });
85
+ if (/rate.?limit|429|too many requests/i.test(message))
86
+ return new FabricError({ code: 'MODEL_RATE_LIMITED', message, cause: error, retryable: true });
87
+ if (/timeout|timed out|aborted/i.test(message))
88
+ return new FabricError({ code: 'MODEL_TIMEOUT', message, cause: error, retryable: true });
89
+ if (/auth|unauthorized|forbidden|401|403|api key/i.test(message))
90
+ return new FabricError({ code: 'MODEL_AUTH_FAILED', message, cause: error });
91
+ return new FabricError({ code: 'UNKNOWN', message, cause: error });
92
+ }
93
+ export const defaultLoopRuntime = new NativeLoopRuntime();
94
+ //# sourceMappingURL=loop.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"loop.js","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ import type { McpClientLike, McpToolDescriptor } from './mcp.js';
2
+ export interface StdioMcpClientOptions {
3
+ command: string;
4
+ args?: string[];
5
+ cwd?: string;
6
+ env?: Record<string, string>;
7
+ requestTimeoutMs?: number;
8
+ }
9
+ export declare class StdioMcpClient implements McpClientLike {
10
+ private readonly child;
11
+ private readonly pending;
12
+ private readonly requestTimeoutMs;
13
+ private nextId;
14
+ private buffer;
15
+ constructor(options: StdioMcpClientOptions);
16
+ listTools(): Promise<McpToolDescriptor[]>;
17
+ callTool(input: {
18
+ name: string;
19
+ arguments?: unknown;
20
+ }): Promise<unknown>;
21
+ close(): Promise<void>;
22
+ private request;
23
+ private onData;
24
+ private handleMessage;
25
+ private rejectAll;
26
+ }
27
+ export declare function createStdioMcpClient(options: StdioMcpClientOptions): StdioMcpClient;
28
+ //# sourceMappingURL=mcp-stdio.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-stdio.d.ts","sourceRoot":"","sources":["../src/mcp-stdio.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEjE,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAQD,qBAAa,cAAe,YAAW,aAAa;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,MAAM,CAAmB;gBAErB,OAAO,EAAE,qBAAqB;IAepC,SAAS,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAMzC,QAAQ,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,CAAC,OAAO;IAef,OAAO,CAAC,MAAM;IAqBd,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,SAAS;CAOlB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAEnF"}
@@ -0,0 +1,102 @@
1
+ import { spawn } from 'node:child_process';
2
+ export class StdioMcpClient {
3
+ child;
4
+ pending = new Map();
5
+ requestTimeoutMs;
6
+ nextId = 1;
7
+ buffer = Buffer.alloc(0);
8
+ constructor(options) {
9
+ this.requestTimeoutMs = options.requestTimeoutMs ?? 30_000;
10
+ this.child = spawn(options.command, options.args ?? [], {
11
+ cwd: options.cwd,
12
+ env: { ...process.env, ...(options.env ?? {}) },
13
+ windowsHide: true,
14
+ });
15
+ this.child.stdout.on('data', (chunk) => this.onData(Buffer.from(chunk)));
16
+ this.child.stderr.on('data', () => {
17
+ // stderr is intentionally not forwarded into model context; callers may wrap the process for diagnostics.
18
+ });
19
+ this.child.on('error', (error) => this.rejectAll(error));
20
+ this.child.on('close', (code) => this.rejectAll(new Error(`MCP stdio process exited with code ${code ?? 'unknown'}.`)));
21
+ }
22
+ async listTools() {
23
+ const result = await this.request('tools/list', {});
24
+ const tools = result.tools;
25
+ return Array.isArray(tools) ? tools : [];
26
+ }
27
+ async callTool(input) {
28
+ return this.request('tools/call', { name: input.name, arguments: input.arguments ?? {} });
29
+ }
30
+ async close() {
31
+ this.child.kill('SIGTERM');
32
+ }
33
+ request(method, params) {
34
+ const id = this.nextId++;
35
+ const message = JSON.stringify({ jsonrpc: '2.0', id, method, params });
36
+ const framed = `Content-Length: ${Buffer.byteLength(message, 'utf8')}\r\n\r\n${message}`;
37
+ return new Promise((resolve, reject) => {
38
+ const pending = { resolve, reject };
39
+ pending.timeout = setTimeout(() => {
40
+ this.pending.delete(id);
41
+ reject(new Error(`MCP request timed out: ${method}`));
42
+ }, this.requestTimeoutMs);
43
+ this.pending.set(id, pending);
44
+ this.child.stdin.write(framed, 'utf8');
45
+ });
46
+ }
47
+ onData(chunk) {
48
+ this.buffer = Buffer.concat([this.buffer, chunk]);
49
+ while (true) {
50
+ const headerEnd = this.buffer.indexOf('\r\n\r\n');
51
+ if (headerEnd === -1)
52
+ return;
53
+ const header = this.buffer.slice(0, headerEnd).toString('utf8');
54
+ const match = /content-length:\s*(\d+)/i.exec(header);
55
+ if (!match) {
56
+ this.buffer = this.buffer.slice(headerEnd + 4);
57
+ continue;
58
+ }
59
+ const length = Number(match[1]);
60
+ const bodyStart = headerEnd + 4;
61
+ const bodyEnd = bodyStart + length;
62
+ if (this.buffer.length < bodyEnd)
63
+ return;
64
+ const body = this.buffer.slice(bodyStart, bodyEnd).toString('utf8');
65
+ this.buffer = this.buffer.slice(bodyEnd);
66
+ this.handleMessage(body);
67
+ }
68
+ }
69
+ handleMessage(body) {
70
+ let message;
71
+ try {
72
+ message = JSON.parse(body);
73
+ }
74
+ catch {
75
+ return;
76
+ }
77
+ if (typeof message.id !== 'number')
78
+ return;
79
+ const pending = this.pending.get(message.id);
80
+ if (!pending)
81
+ return;
82
+ this.pending.delete(message.id);
83
+ if (pending.timeout)
84
+ clearTimeout(pending.timeout);
85
+ if (message.error)
86
+ pending.reject(new Error(message.error.message ?? 'MCP request failed.'));
87
+ else
88
+ pending.resolve(message.result);
89
+ }
90
+ rejectAll(error) {
91
+ for (const [id, pending] of this.pending.entries()) {
92
+ this.pending.delete(id);
93
+ if (pending.timeout)
94
+ clearTimeout(pending.timeout);
95
+ pending.reject(error);
96
+ }
97
+ }
98
+ }
99
+ export function createStdioMcpClient(options) {
100
+ return new StdioMcpClient(options);
101
+ }
102
+ //# sourceMappingURL=mcp-stdio.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-stdio.js","sourceRoot":"","sources":["../src/mcp-stdio.ts"],"names":[],"mappings":"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"}
package/dist/mcp.d.ts ADDED
@@ -0,0 +1,40 @@
1
+ import type { ToolDef } from './tools.js';
2
+ import type { JsonObject } from './types.js';
3
+ export interface McpToolDescriptor {
4
+ name: string;
5
+ description?: string;
6
+ inputSchema?: JsonObject;
7
+ }
8
+ export interface McpClientLike {
9
+ listTools(): Promise<McpToolDescriptor[]>;
10
+ callTool(input: {
11
+ name: string;
12
+ arguments?: unknown;
13
+ }): Promise<unknown>;
14
+ }
15
+ export interface CreateMcpToolsOptions {
16
+ prefix?: string;
17
+ effect?: 'read' | 'write' | 'execute' | 'none';
18
+ source?: string;
19
+ }
20
+ export type McpTransport = 'streamable-http' | 'sse';
21
+ type HeaderInput = Record<string, string> | Array<[string, string]> | Headers;
22
+ export interface McpServerOptions {
23
+ url: string | URL;
24
+ /** Defaults to modern streamable HTTP. Use 'sse' for legacy MCP servers. */
25
+ transport?: McpTransport;
26
+ headers?: HeaderInput;
27
+ requestInit?: RequestInit;
28
+ fetch?: typeof fetch;
29
+ clientName?: string;
30
+ clientVersion?: string;
31
+ }
32
+ export interface McpServerConnection {
33
+ name: string;
34
+ tools: ToolDef[];
35
+ close(): Promise<void>;
36
+ }
37
+ export declare function createMcpTools(client: McpClientLike, options?: CreateMcpToolsOptions): Promise<ToolDef[]>;
38
+ export declare function connectMcpServer(name: string, options: McpServerOptions): Promise<McpServerConnection>;
39
+ export {};
40
+ //# sourceMappingURL=mcp.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,KAAK,CAAC;AAErD,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC;AAE9E,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IAClB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAmBnH;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqB5G"}
package/dist/mcp.js ADDED
@@ -0,0 +1,153 @@
1
+ import { Client } from '@modelcontextprotocol/sdk/client/index.js';
2
+ import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
3
+ export async function createMcpTools(client, options = {}) {
4
+ const tools = await client.listTools();
5
+ return tools.map((tool) => {
6
+ const publicName = `${options.prefix ?? 'mcp'}_${tool.name}`.replace(/[^a-zA-Z0-9_-]/g, '_');
7
+ const def = {
8
+ name: publicName,
9
+ ...(tool.description ? { description: tool.description } : {}),
10
+ ...(tool.inputSchema ? { inputSchema: tool.inputSchema } : {}),
11
+ metadata: {
12
+ effect: options.effect ?? 'execute',
13
+ mcp: {
14
+ source: options.source ?? 'mcp',
15
+ tool: tool.name,
16
+ },
17
+ },
18
+ execute: async (input) => client.callTool({ name: tool.name, arguments: input }),
19
+ };
20
+ return def;
21
+ });
22
+ }
23
+ export async function connectMcpServer(name, options) {
24
+ const url = options.url instanceof URL ? options.url : new URL(options.url);
25
+ const requestInit = mergeRequestInit(options.requestInit, options.headers);
26
+ const transport = await createTransport(url, options.transport ?? 'streamable-http', requestInit, options.fetch);
27
+ const client = new Client({
28
+ name: options.clientName ?? 'fabric-harness',
29
+ version: options.clientVersion ?? '0.0.0',
30
+ });
31
+ try {
32
+ await client.connect(transport);
33
+ const { tools } = await client.listTools();
34
+ return {
35
+ name,
36
+ tools: createConnectedMcpTools(name, client, tools),
37
+ close: () => client.close(),
38
+ };
39
+ }
40
+ catch (error) {
41
+ await client.close().catch(() => undefined);
42
+ throw error;
43
+ }
44
+ }
45
+ async function createTransport(url, transport, requestInit, fetchImpl) {
46
+ const transportOptions = fetchImpl ? { requestInit, fetch: fetchImpl } : { requestInit };
47
+ if (transport === 'sse') {
48
+ const { SSEClientTransport } = await import('@modelcontextprotocol/sdk/client/sse.js');
49
+ return new SSEClientTransport(url, transportOptions);
50
+ }
51
+ return new StreamableHTTPClientTransport(url, transportOptions);
52
+ }
53
+ function createConnectedMcpTools(serverName, client, tools) {
54
+ const names = new Set();
55
+ return tools.map((tool) => {
56
+ const toolName = createToolName(serverName, tool.name);
57
+ if (names.has(toolName)) {
58
+ throw new Error(`MCP tools from server "${serverName}" produced duplicate tool name "${toolName}".`);
59
+ }
60
+ names.add(toolName);
61
+ return {
62
+ name: toolName,
63
+ description: createToolDescription(serverName, tool),
64
+ inputSchema: normalizeInputSchema(tool.inputSchema),
65
+ metadata: {
66
+ effect: 'execute',
67
+ mcp: {
68
+ source: serverName,
69
+ tool: tool.name,
70
+ },
71
+ },
72
+ async execute(args) {
73
+ const result = await client.callTool({ name: tool.name, arguments: args });
74
+ const text = formatMcpResult(result);
75
+ if (result.isError)
76
+ throw new Error(text);
77
+ return text;
78
+ },
79
+ };
80
+ });
81
+ }
82
+ function mergeRequestInit(requestInit, headers) {
83
+ if (!headers)
84
+ return requestInit ?? {};
85
+ const mergedHeaders = new Headers(requestInit?.headers);
86
+ for (const [key, value] of headerEntries(headers))
87
+ mergedHeaders.set(key, value);
88
+ return { ...requestInit, headers: mergedHeaders };
89
+ }
90
+ function headerEntries(headers) {
91
+ if (headers instanceof Headers)
92
+ return [...headers.entries()];
93
+ if (Array.isArray(headers))
94
+ return headers;
95
+ return Object.entries(headers);
96
+ }
97
+ function createToolName(serverName, toolName) {
98
+ return `mcp__${sanitizeToolNamePart(serverName)}__${sanitizeToolNamePart(toolName)}`;
99
+ }
100
+ function sanitizeToolNamePart(value) {
101
+ const sanitized = value.replace(/[^A-Za-z0-9_-]/g, '_').replace(/^_+|_+$/g, '');
102
+ return sanitized || 'unnamed';
103
+ }
104
+ function createToolDescription(serverName, tool) {
105
+ const originalName = tool.name;
106
+ const title = tool.title ?? tool.annotations?.title;
107
+ const parts = [`MCP tool "${originalName}" from server "${serverName}".`];
108
+ if (title && title !== originalName)
109
+ parts.push(`Title: ${title}.`);
110
+ if (tool.description)
111
+ parts.push(tool.description);
112
+ return parts.join(' ');
113
+ }
114
+ function normalizeInputSchema(inputSchema) {
115
+ return {
116
+ ...inputSchema,
117
+ type: inputSchema.type ?? 'object',
118
+ properties: inputSchema.properties ?? {},
119
+ ...(inputSchema.required ? { required: [...inputSchema.required] } : {}),
120
+ };
121
+ }
122
+ function formatMcpResult(result) {
123
+ const parts = [];
124
+ if (result.structuredContent !== undefined) {
125
+ parts.push(`Structured content:\n${JSON.stringify(result.structuredContent, null, 2)}`);
126
+ }
127
+ for (const item of result.content ?? []) {
128
+ if (item.type === 'text') {
129
+ parts.push(item.text);
130
+ }
131
+ else if (item.type === 'image') {
132
+ parts.push(`[Image: ${item.mimeType}, ${item.data.length} base64 chars]`);
133
+ }
134
+ else if (item.type === 'audio') {
135
+ parts.push(`[Audio: ${item.mimeType}, ${item.data.length} base64 chars]`);
136
+ }
137
+ else if (item.type === 'resource') {
138
+ const resource = item.resource;
139
+ parts.push('text' in resource ? `[Resource: ${resource.uri}]\n${resource.text}` : `[Resource: ${resource.uri}, ${resource.blob.length} base64 chars]`);
140
+ }
141
+ else if (item.type === 'resource_link') {
142
+ const description = item.description ? ` - ${item.description}` : '';
143
+ parts.push(`[Resource link: ${item.name} (${item.uri})${description}]`);
144
+ }
145
+ else {
146
+ parts.push(JSON.stringify(item));
147
+ }
148
+ }
149
+ if (parts.length === 0 && 'toolResult' in result)
150
+ parts.push(JSON.stringify(result.toolResult, null, 2));
151
+ return parts.filter(Boolean).join('\n\n') || '(MCP tool returned no content)';
152
+ }
153
+ //# sourceMappingURL=mcp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"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"}