@agenttrust-sdk/mcp 0.3.0 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/README.md +25 -3
  2. package/dist/chain.js +4 -2
  3. package/dist/chain.js.map +1 -1
  4. package/dist/config.d.ts +22 -2
  5. package/dist/config.js +165 -15
  6. package/dist/config.js.map +1 -1
  7. package/dist/embedded-docs/mcp/hosted-endpoint.mdx +1 -1
  8. package/dist/embedded-docs/mcp/install.mdx +12 -3
  9. package/dist/embedded-docs/mcp/tools.mdx +2 -2
  10. package/dist/embedded-docs/quickstart.mdx +83 -0
  11. package/dist/errors.d.ts +79 -0
  12. package/dist/errors.js +277 -0
  13. package/dist/errors.js.map +1 -0
  14. package/dist/index.js +13 -6
  15. package/dist/index.js.map +1 -1
  16. package/dist/server.js +19 -16
  17. package/dist/server.js.map +1 -1
  18. package/dist/tools/discovery/docs.d.ts +6 -0
  19. package/dist/tools/discovery/docs.js +13 -1
  20. package/dist/tools/discovery/docs.js.map +1 -1
  21. package/dist/tools/discovery/facilitator-walkthrough.d.ts +5 -0
  22. package/dist/tools/discovery/facilitator-walkthrough.js +13 -2
  23. package/dist/tools/discovery/facilitator-walkthrough.js.map +1 -1
  24. package/dist/tools/index.js +2 -0
  25. package/dist/tools/index.js.map +1 -1
  26. package/dist/tools/read/get-quantu-reputation.d.ts +23 -3
  27. package/dist/tools/read/get-quantu-reputation.js +32 -7
  28. package/dist/tools/read/get-quantu-reputation.js.map +1 -1
  29. package/dist/tools/read/simulate-payment.js +13 -13
  30. package/dist/tools/read/simulate-payment.js.map +1 -1
  31. package/dist/tools/write/emit-feedback.d.ts +4 -4
  32. package/dist/tools/write/emit-feedback.js +55 -12
  33. package/dist/tools/write/emit-feedback.js.map +1 -1
  34. package/dist/tools/write/init-authority.d.ts +43 -0
  35. package/dist/tools/write/init-authority.js +92 -0
  36. package/dist/tools/write/init-authority.js.map +1 -0
  37. package/dist/tools/write/init-policy.d.ts +23 -3
  38. package/dist/tools/write/init-policy.js +92 -15
  39. package/dist/tools/write/init-policy.js.map +1 -1
  40. package/dist/tools/write/request-validation.js +6 -2
  41. package/dist/tools/write/request-validation.js.map +1 -1
  42. package/dist/tools/write/respond-to-validation.d.ts +3 -2
  43. package/dist/tools/write/respond-to-validation.js +10 -7
  44. package/dist/tools/write/respond-to-validation.js.map +1 -1
  45. package/dist/tools/write/set-killswitch.d.ts +10 -0
  46. package/dist/tools/write/set-killswitch.js +63 -14
  47. package/dist/tools/write/set-killswitch.js.map +1 -1
  48. package/package.json +1 -1
  49. package/dist/embedded-docs/getting-started/architecture-overview.mdx +0 -85
  50. package/dist/embedded-docs/reference/formal-verification.mdx +0 -19
  51. package/dist/embedded-docs/sdk/atomic-tx-invariant.mdx +0 -37
package/dist/errors.js ADDED
@@ -0,0 +1,277 @@
1
+ "use strict";
2
+ /**
3
+ * Structured error envelopes for MCP `tools/call` responses (F-013).
4
+ *
5
+ * Before this module, every thrown handler error was flattened to
6
+ * `{ isError: true, content: [{type:"text",text:"tool error: <msg>"}] }`
7
+ * — opaque to LLM agents and useless for automated recovery.
8
+ *
9
+ * Now `classifyError()` inspects the thrown value and produces a
10
+ * `ToolError` with:
11
+ * - `errorCode`: one of a fixed enum so callers can branch on it.
12
+ * - `message`: short human description (truncated original).
13
+ * - `hint`: single sentence of remediation guidance.
14
+ * - `cause`: truncated original message (<=500 chars) for debugging.
15
+ *
16
+ * `renderToolError()` serialises that envelope into the MCP
17
+ * `CallToolResult` shape. The envelope is JSON-encoded into
18
+ * `content[0].text` (so transports that only surface text still get a
19
+ * parseable payload), AND mirrored into `structuredContent` (the MCP
20
+ * spec field for machine-readable tool output, supported by the
21
+ * `@modelcontextprotocol/sdk` schema we already depend on).
22
+ *
23
+ * Tool handlers do NOT need to change. They still:
24
+ * - `throw new Error("...")` for ad-hoc failures
25
+ * - `throw new ZodError(...)` (implicitly, via `schema.parse()`)
26
+ * - throw `AnchorError` / `SendTransactionError` (via `.rpc()` calls)
27
+ * The classifier sniffs the thrown value (name, message prefix,
28
+ * `instanceof` where the constructor is in scope) and maps it.
29
+ *
30
+ * Note for future contributors: callers reading `content[0].text` as a
31
+ * string will see a JSON object now, not a plain sentence. This is
32
+ * intentional — `isError: true` is preserved so existing transports
33
+ * still treat it as a failure. If you add a new tool that throws a
34
+ * specific subclass, extend `classifyError()` here rather than
35
+ * pattern-matching in `server.ts`.
36
+ */
37
+ Object.defineProperty(exports, "__esModule", { value: true });
38
+ exports.classifyError = classifyError;
39
+ exports.renderToolError = renderToolError;
40
+ const zod_1 = require("zod");
41
+ /** Cap raw error messages at this many characters to keep payloads sane. */
42
+ const MAX_CAUSE_LEN = 500;
43
+ /** Truncate with a tail marker so it's obvious what got cut. */
44
+ function clamp(s, max = MAX_CAUSE_LEN) {
45
+ if (s.length <= max)
46
+ return s;
47
+ return s.slice(0, max - 16) + "... [truncated]";
48
+ }
49
+ /**
50
+ * Extract a `message` string from an unknown thrown value. JS code can
51
+ * `throw "string"`, `throw {message}`, `throw new Error()`, or `throw 42`,
52
+ * and the classifier needs a string in every case.
53
+ */
54
+ function readMessage(err) {
55
+ if (err == null)
56
+ return "(unknown error)";
57
+ if (typeof err === "string")
58
+ return err;
59
+ if (err instanceof Error)
60
+ return err.message;
61
+ if (typeof err === "object" && "message" in err) {
62
+ const m = err.message;
63
+ if (typeof m === "string")
64
+ return m;
65
+ }
66
+ try {
67
+ return JSON.stringify(err);
68
+ }
69
+ catch {
70
+ return String(err);
71
+ }
72
+ }
73
+ /** Return the constructor name when present — useful for cross-version detection. */
74
+ function readName(err) {
75
+ if (err == null)
76
+ return "";
77
+ if (err instanceof Error)
78
+ return err.name || err.constructor?.name || "";
79
+ if (typeof err === "object" && err.constructor)
80
+ return err.constructor.name;
81
+ return "";
82
+ }
83
+ /**
84
+ * Inspect a `ZodError`'s first issue and render it as a one-line hint.
85
+ * Keeps the LLM's recovery prompt short; full `issues` array goes into
86
+ * `cause` so a debugging agent can still drill in.
87
+ */
88
+ function formatZodHint(zErr) {
89
+ const first = zErr.issues[0];
90
+ if (!first)
91
+ return "Fix the input shape and retry.";
92
+ const path = first.path.length > 0 ? first.path.join(".") : "(root)";
93
+ return `Fix field "${path}": ${first.message}`;
94
+ }
95
+ /**
96
+ * Anchor errors expose structured `error.errorMessage` plus on-chain
97
+ * `logs`. We surface the human message as the hint and put a few key
98
+ * log lines in the cause to help LLMs trace the constraint failure.
99
+ */
100
+ function formatAnchorHint(err) {
101
+ const e = err;
102
+ const msg = e.error?.errorMessage;
103
+ const code = e.error?.errorCode?.code;
104
+ if (msg && code)
105
+ return `On-chain ${code}: ${msg}.`;
106
+ if (msg)
107
+ return `On-chain error: ${msg}.`;
108
+ return undefined;
109
+ }
110
+ /**
111
+ * Heuristic name/message matchers. Anchor + web3.js may be present in
112
+ * multiple versions in a pnpm workspace (we saw two `@coral-xyz/anchor`
113
+ * trees), so we cannot rely on a single `instanceof`. String checks on
114
+ * `err.name` are the cross-version-safe path.
115
+ */
116
+ function isAnchorError(err, name, message) {
117
+ if (name === "AnchorError")
118
+ return true;
119
+ // AnchorError.toString() includes "AnchorError caused by account..."
120
+ if (message.startsWith("AnchorError"))
121
+ return true;
122
+ // SendTransactionError wraps AnchorError for .rpc() calls
123
+ if (/Error Code:\s*\w+\.\s*Error Number:\s*\d+/i.test(message))
124
+ return true;
125
+ // CPI-deep failures bubble up `custom program error: 0x...`
126
+ if (/custom program error:\s*0x[0-9a-f]+/i.test(message))
127
+ return true;
128
+ return false;
129
+ }
130
+ function isRpcFailure(name, message) {
131
+ if (name === "SolanaJSONRPCError")
132
+ return true;
133
+ if (/^failed to get/i.test(message))
134
+ return true;
135
+ if (/\b429\b/.test(message))
136
+ return true;
137
+ if (/\btimed out\b/i.test(message))
138
+ return true;
139
+ if (/\bECONNREFUSED\b/.test(message))
140
+ return true;
141
+ if (/\bENOTFOUND\b/.test(message))
142
+ return true;
143
+ if (/fetch failed/i.test(message))
144
+ return true;
145
+ return false;
146
+ }
147
+ function isNotFound(message) {
148
+ if (/not initialised|not initialized/i.test(message))
149
+ return true;
150
+ if (/AccountNotFound/i.test(message))
151
+ return true;
152
+ if (/IDL not found|idl account does not exist/i.test(message))
153
+ return true;
154
+ if (/Account does not exist/i.test(message))
155
+ return true;
156
+ return false;
157
+ }
158
+ /**
159
+ * Tag a `requireSigner()` failure as `auth_required`. The thrown message
160
+ * is hardcoded in `ChainClient.requireSigner()` — we match on a stable
161
+ * substring so the classifier doesn't break if the surrounding sentence
162
+ * is reworded.
163
+ *
164
+ * TODO (F-014): once `requireSigner(toolName)` exists, the hint can name
165
+ * the specific tool that needed auth instead of a generic blurb.
166
+ */
167
+ function isAuthRequired(message) {
168
+ return /requires a signer/i.test(message);
169
+ }
170
+ /**
171
+ * Classify an unknown thrown value into a structured `ToolError`.
172
+ *
173
+ * @param err The thrown value from a tool handler (or Zod parse).
174
+ * @param toolName Optional — the MCP tool that was being invoked. When
175
+ * supplied, surfaces in the `auth_required` hint so the
176
+ * LLM agent knows which call to retry.
177
+ */
178
+ function classifyError(err, toolName) {
179
+ const message = readMessage(err);
180
+ const name = readName(err);
181
+ const cause = clamp(message);
182
+ // 1. Auth — caught first because the message is hardcoded and stable.
183
+ if (isAuthRequired(message)) {
184
+ const which = toolName ? ` (needed by \`${toolName}\`)` : "";
185
+ return {
186
+ errorCode: "auth_required",
187
+ message: `Signer required${which}.`,
188
+ hint: "Set KEYPAIR_B58 (base58-encoded 64-byte secret), KEYPAIR_PATH, " +
189
+ "or `solana config get` to point at a funded keypair, then restart the MCP server.",
190
+ cause,
191
+ };
192
+ }
193
+ // 2. Zod schema validation — `instanceof ZodError` works because the
194
+ // server passes the parse error through directly (no wrapping).
195
+ if (err instanceof zod_1.ZodError) {
196
+ return {
197
+ errorCode: "input_invalid",
198
+ message: "Input validation failed.",
199
+ hint: formatZodHint(err),
200
+ cause: clamp(JSON.stringify(err.issues)),
201
+ };
202
+ }
203
+ // 3. Anchor / on-chain program errors.
204
+ if (isAnchorError(err, name, message)) {
205
+ return {
206
+ errorCode: "chain_error",
207
+ message: "On-chain transaction failed.",
208
+ hint: formatAnchorHint(err) ??
209
+ "Inspect the transaction logs on the explorer; the failing constraint or " +
210
+ "custom error code is included in the cause.",
211
+ cause,
212
+ };
213
+ }
214
+ // 4. RPC / connectivity issues.
215
+ if (isRpcFailure(name, message)) {
216
+ return {
217
+ errorCode: "rpc_failure",
218
+ message: "RPC call failed.",
219
+ hint: "Check `RPC_URL` env, switch to a dedicated RPC provider (e.g., Helius/Triton), " +
220
+ "or retry after a short backoff.",
221
+ cause,
222
+ };
223
+ }
224
+ // 5. Account / IDL / facilitator not found.
225
+ if (isNotFound(message)) {
226
+ return {
227
+ errorCode: "not_found",
228
+ message: "Required account or IDL was not found on-chain.",
229
+ hint: "Run the matching init/register tool before this one, or verify you are " +
230
+ "pointed at the correct cluster (devnet vs mainnet).",
231
+ cause,
232
+ };
233
+ }
234
+ // 6. Fallback.
235
+ return {
236
+ errorCode: "internal",
237
+ message: "Tool handler threw an unexpected error.",
238
+ hint: "See `cause` for the original message and check the MCP server stderr for stack trace.",
239
+ cause,
240
+ };
241
+ }
242
+ /**
243
+ * Build the MCP `CallToolResult` envelope for a classified error.
244
+ *
245
+ * Returns the canonical shape:
246
+ * {
247
+ * isError: true,
248
+ * content: [{ type: "text", text: "<json string>" }],
249
+ * structuredContent: <ToolError as object>
250
+ * }
251
+ *
252
+ * The JSON-in-text duplication is intentional: MCP clients that only
253
+ * surface text content (current Claude Desktop fallback path) still get
254
+ * a parseable payload, while spec-compliant clients pick up the
255
+ * structured field directly.
256
+ *
257
+ * The return type is `unknown` so callers don't need to import the SDK's
258
+ * private `CallToolResult` zod type — the server handler returns
259
+ * `Promise<{ ... }>` and TS infers the shape at the call site.
260
+ */
261
+ function renderToolError(toolError) {
262
+ // Preserve original key order in the JSON for human-readability.
263
+ const ordered = {
264
+ errorCode: toolError.errorCode,
265
+ message: toolError.message,
266
+ };
267
+ if (toolError.hint !== undefined)
268
+ ordered.hint = toolError.hint;
269
+ if (toolError.cause !== undefined)
270
+ ordered.cause = toolError.cause;
271
+ return {
272
+ isError: true,
273
+ content: [{ type: "text", text: JSON.stringify(ordered, null, 2) }],
274
+ structuredContent: ordered,
275
+ };
276
+ }
277
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -16,7 +16,7 @@ const HELP_TEXT = `agenttrust-mcp — Model Context Protocol server for AgentTru
16
16
 
17
17
  USAGE
18
18
  agenttrust-mcp Start in stdio mode (Claude Desktop / Cursor)
19
- MCP_TRANSPORT=http agenttrust-mcp Start in HTTP mode on \$MCP_HTTP_PORT (default 8080)
19
+ MCP_TRANSPORT=http agenttrust-mcp Start in HTTP mode on $MCP_HTTP_PORT (default 8765)
20
20
 
21
21
  INSTALL — Claude Desktop
22
22
  Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
@@ -35,12 +35,15 @@ INSTALL — Cursor
35
35
  ENVIRONMENT
36
36
  RPC_URL Solana RPC endpoint (default: devnet)
37
37
  NETWORK solana-devnet | solana-mainnet
38
- KEYPAIR_B58 Base58 64-byte secret. Required for write tools.
38
+ KEYPAIR_B58 Base58 64-byte secret. One way to supply a signer.
39
+ KEYPAIR_PATH Path to a Solana CLI keypair JSON. Alt signer source.
40
+ (~/.config/solana/id.json is picked up automatically.)
39
41
  MCP_TRANSPORT stdio (default) | http
40
- MCP_HTTP_PORT 8080 (default; Fly.io also injects PORT)
42
+ MCP_HTTP_PORT 8765 (default; Fly.io also injects PORT)
43
+ MCP_HTTP_HOST 127.0.0.1 (default). Set 0.0.0.0 for hosted deploys.
41
44
 
42
45
  DOCS
43
- Tools / resources / prompts: https://agenttrust-labs.github.io/agenttrust/mcp
46
+ Tools / resources / prompts: https://docs.agenttrust.tech/mcp
44
47
  Repo: https://github.com/agenttrust-labs/agenttrust
45
48
  `;
46
49
  async function main() {
@@ -158,9 +161,13 @@ async function main() {
158
161
  res.writeHead(500).end();
159
162
  }
160
163
  });
161
- httpServer.listen(cfg.httpPort, () => {
164
+ httpServer.listen(cfg.httpPort, cfg.httpHost, () => {
165
+ // Banner prints http://localhost so a developer can click the link
166
+ // even when bound to 127.0.0.1 or 0.0.0.0. The actual bind address
167
+ // (cfg.httpHost) is appended for machine logs / ops debugging.
162
168
  // eslint-disable-next-line no-console
163
- console.error(`AgentTrust MCP server listening on http://0.0.0.0:${cfg.httpPort}`);
169
+ console.error(`AgentTrust MCP server listening on http://localhost:${cfg.httpPort} ` +
170
+ `(bind ${cfg.httpHost}:${cfg.httpPort})`);
164
171
  });
165
172
  return;
166
173
  }
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AACA;;;;;;;GAOG;;AAEH,wEAAiF;AAEjF,qCAAsC;AACtC,qCAA2C;AAE3C,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCjB,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,mEAAmE;IACnE,gEAAgE;IAChE,8BAA8B;IAC9B,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO;IACT,CAAC;IACD,kDAAkD;IAClD,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,CAAC,EAAE,CAAC;QAC7E,qGAAqG;QACrG,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;QACrD,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,IAAA,mBAAU,GAAE,CAAC;IAEzB,IAAI,GAAG,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QAC7B,8DAA8D;QAC9D,oEAAoE;QACpE,qGAAqG;QACrG,MAAM,EAAE,6BAA6B,EAAE,GAAG,OAAO,CAC/C,oDAAoD,CACrD,CAAC;QACF,qGAAqG;QACrG,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7B,qGAAqG;QACrG,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjC,qGAAqG;QACrG,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAc7B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;QAC5C,MAAM,OAAO,GAAI,EAAE,GAAG,EAAE,GAAG,IAAK,CAAC;QAEjC,WAAW,CAAC,GAAG,EAAE;YACf,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC;gBAChC,IAAI,GAAG,GAAG,CAAC,CAAC,WAAW,GAAG,OAAO,EAAE,CAAC;oBAClC,IAAI,CAAC;wBAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;oBAAC,CAAC;oBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;oBACrD,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,IAAK,CAAC,CAAC,KAAK,EAAE,CAAC;QAE3B,KAAK,UAAU,WAAW;YACxB,MAAM,aAAa,GAAG,IAAA,wBAAe,EAAC,GAAG,CAAC,CAAC;YAC3C,MAAM,gBAAgB,GAAG,IAAI,6BAA6B,CAAC;gBACzD,kBAAkB,EAAI,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE;gBAC/C,8DAA8D;gBAC9D,oBAAoB,EAAE,CAAC,GAAW,EAAE,EAAE;oBACpC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACrG,CAAC;gBACD,8DAA8D;gBAC9D,eAAe,EAAE,CAAC,GAAW,EAAE,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;aAC5D,CAAC,CAAC;YACH,MAAM,aAAa,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;YAC9C,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACzF,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,GAAmC,EAAE,GAAkC,EAAE,EAAE;YACrH,6DAA6D;YAC7D,0DAA0D;YAC1D,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1C,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC;gBAChE,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;oBACrB,EAAE,EAAc,IAAI;oBACpB,OAAO,EAAS,gBAAgB;oBAChC,OAAO,EAAS,GAAG,CAAC,OAAO;oBAC3B,OAAO,EAAS,GAAG,CAAC,OAAO;oBAC3B,MAAM,EAAU,GAAG,CAAC,MAAM;oBAC1B,aAAa,EAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;oBAC3D,cAAc,EAAE,QAAQ,CAAC,IAAI;oBAC7B,sDAAsD;oBACtD,yDAAyD;oBACzD,yDAAyD;oBACzD,kDAAkD;oBAClD,SAAS,EAAO,EAAE;iBACnB,CAAC,GAAG,IAAI,CAAC,CAAC;gBACX,OAAO;YACT,CAAC;YAED,gEAAgE;YAChE,6DAA6D;YAC7D,2CAA2C;YAC3C,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;YAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YACpD,IAAI,OAA4B,CAAC;YACjC,IAAI,SAAS,IAAI,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBACzC,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBAClC,IAAI,OAAO;oBAAE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAChD,CAAC;iBAAM,CAAC;gBACN,iEAAiE;gBACjE,yDAAyD;gBACzD,yDAAyD;gBACzD,2DAA2D;gBAC3D,yBAAyB;gBACzB,IAAI,CAAC;oBACH,OAAO,GAAG,MAAM,WAAW,EAAE,CAAC;gBAChC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,sCAAsC;oBACtC,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC;oBAC7C,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;oBACzB,OAAO;gBACT,CAAC;YACH,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,OAAQ,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACnD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,sCAAsC;gBACtC,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;gBACvC,IAAI,CAAC,GAAG,CAAC,WAAW;oBAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YACjD,CAAC;QACH,CAAC,CAAC,CAAC;QACH,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE;YACjD,mEAAmE;YACnE,mEAAmE;YACnE,+DAA+D;YAC/D,sCAAsC;YACtC,OAAO,CAAC,KAAK,CACX,uDAAuD,GAAG,CAAC,QAAQ,GAAG;gBACtE,SAAS,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,GAAG,CACzC,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,qDAAqD;IACrD,MAAM,MAAM,GAAG,IAAA,wBAAe,EAAC,GAAG,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,sEAAsE;AACxE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
package/dist/server.js CHANGED
@@ -21,6 +21,7 @@ const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
21
21
  const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
22
22
  const zod_to_json_schema_1 = require("zod-to-json-schema");
23
23
  const chain_1 = require("./chain");
24
+ const errors_1 = require("./errors");
24
25
  const prompts_1 = require("./prompts");
25
26
  const programs_1 = require("./resources/programs");
26
27
  const docs_1 = require("./resources/docs");
@@ -33,9 +34,11 @@ const PKG_VERSION = require("../package.json").version;
33
34
  const SERVER_NAME = "agenttrust";
34
35
  const SERVER_VERSION = PKG_VERSION;
35
36
  const SERVER_INSTRUCTIONS = "AgentTrust MCP server. Read tools work without auth (devnet by default). " +
36
- "Write tools require KEYPAIR_B58 in env. Resources expose the AgentTrust " +
37
- "docs corpus, deployed program manifest, and example demo source. Prompts " +
38
- "ship three guided workflows: audit_payment, setup_agent, explain_failure.";
37
+ "Write tools require a signer (KEYPAIR_B58 / KEYPAIR_PATH / Solana CLI " +
38
+ "default ~/.config/solana/id.json; full chain documented in the MCP " +
39
+ "README). Resources expose the AgentTrust docs corpus, deployed program " +
40
+ "manifest, and example demo source. Prompts ship three guided workflows: " +
41
+ "audit_payment, setup_agent, explain_failure.";
39
42
  function createMcpServer(cfg) {
40
43
  const chain = new chain_1.ChainClient(cfg);
41
44
  const server = new index_js_1.Server({ name: SERVER_NAME, version: SERVER_VERSION }, {
@@ -52,23 +55,26 @@ function createMcpServer(cfg) {
52
55
  })),
53
56
  }));
54
57
  // ---- tools/call ---------------------------------------------------------
58
+ // Every failure path here goes through `classifyError → renderToolError`
59
+ // so MCP clients see a uniform `{ errorCode, message, hint, cause }`
60
+ // envelope (F-013). The classifier handles plain `Error`, `ZodError`,
61
+ // `AnchorError`, `SendTransactionError`, and unknown throws.
55
62
  server.setRequestHandler(types_js_1.CallToolRequestSchema, async (req) => {
56
- const tool = tools_1.ALL_TOOLS.find((t) => t.name === req.params.name);
63
+ const toolName = req.params.name;
64
+ const tool = tools_1.ALL_TOOLS.find((t) => t.name === toolName);
57
65
  if (!tool) {
58
- return {
59
- isError: true,
60
- content: [{ type: "text", text: `unknown tool: ${req.params.name}` }],
61
- };
66
+ return (0, errors_1.renderToolError)({
67
+ errorCode: "not_found",
68
+ message: `Unknown tool: ${toolName}.`,
69
+ hint: "Call `tools/list` to discover the available tool names.",
70
+ });
62
71
  }
63
72
  let parsed;
64
73
  try {
65
74
  parsed = tool.inputSchema.parse(req.params.arguments ?? {});
66
75
  }
67
76
  catch (err) {
68
- return {
69
- isError: true,
70
- content: [{ type: "text", text: `input validation failed: ${err.message}` }],
71
- };
77
+ return (0, errors_1.renderToolError)((0, errors_1.classifyError)(err, toolName));
72
78
  }
73
79
  try {
74
80
  const result = await tool.handler(parsed, { chain });
@@ -77,10 +83,7 @@ function createMcpServer(cfg) {
77
83
  };
78
84
  }
79
85
  catch (err) {
80
- return {
81
- isError: true,
82
- content: [{ type: "text", text: `tool error: ${err.message}` }],
83
- };
86
+ return (0, errors_1.renderToolError)((0, errors_1.classifyError)(err, toolName));
84
87
  }
85
88
  });
86
89
  // ---- resources/list ----------------------------------------------------
@@ -1 +1 @@
1
- {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;AA8CH,0CA0GC;AAtJD,wEAAmE;AACnE,iEAO4C;AAC5C,2DAAqD;AAErD,mCAAsC;AAEtC,qCAA0D;AAC1D,uCAAwC;AACxC,mDAI8B;AAC9B,2CAK0B;AAC1B,mCAAoC;AAEpC,oEAAoE;AACpE,qEAAqE;AACrE,gEAAgE;AAChE,qGAAqG;AACrG,MAAM,WAAW,GAAI,OAAO,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC;AAChF,MAAM,WAAW,GAAM,YAAY,CAAC;AACpC,MAAM,cAAc,GAAG,WAAW,CAAC;AAEnC,MAAM,mBAAmB,GACvB,2EAA2E;IAC3E,wEAAwE;IACxE,qEAAqE;IACrE,yEAAyE;IACzE,0EAA0E;IAC1E,8CAA8C,CAAC;AAEjD,SAAgB,eAAe,CAAC,GAAqB;IACnD,MAAM,KAAK,GAAI,IAAI,mBAAW,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,iBAAM,CACvB,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,EAC9C;QACE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACvD,YAAY,EAAE,mBAAmB;KAClC,CACF,CAAC;IAEF,4EAA4E;IAC5E,MAAM,CAAC,iBAAiB,CAAC,iCAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,iBAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,IAAI,EAAS,CAAC,CAAC,IAAI;YACnB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,8DAA8D;YAC9D,WAAW,EAAE,IAAA,oCAAe,EAAC,CAAC,CAAC,WAAkB,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAA4B;SACtG,CAAC,CAAC;KACJ,CAAC,CAAC,CAAC;IAEJ,4EAA4E;IAC5E,yEAAyE;IACzE,qEAAqE;IACrE,sEAAsE;IACtE,6DAA6D;IAC7D,MAAM,CAAC,iBAAiB,CAAC,gCAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5D,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QACjC,MAAM,IAAI,GAAG,iBAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAA,wBAAe,EAAC;gBACrB,SAAS,EAAE,WAAW;gBACtB,OAAO,EAAI,iBAAiB,QAAQ,GAAG;gBACvC,IAAI,EAAO,yDAAyD;aACrE,CAAC,CAAC;QACL,CAAC;QACD,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAA,wBAAe,EAAC,IAAA,sBAAa,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACrD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAA,wBAAe,EAAC,IAAA,sBAAa,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,2EAA2E;IAC3E,MAAM,CAAC,iBAAiB,CAAC,qCAA0B,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAChE,SAAS,EAAE;YACT,IAAA,mCAAwB,GAAE;YAC1B,GAAG,IAAA,wBAAiB,GAAE;YACtB,GAAG,IAAA,2BAAoB,GAAE;SAC1B;KACF,CAAC,CAAC,CAAC;IAEJ,2EAA2E;IAC3E,MAAM,CAAC,iBAAiB,CAAC,oCAAyB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAChE,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;QAC3B,IAAI,GAAG,KAAK,gCAAqB,EAAE,CAAC;YAClC,MAAM,CAAC,GAAG,IAAA,+BAAoB,EAAC,GAAG,CAAC,CAAC;YACpC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,CAAC;QACD,MAAM,IAAI,GAAG,IAAA,uBAAgB,EAAC,GAAG,CAAC,CAAC;QACnC,IAAI,IAAI;YAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,EAAE,GAAG,IAAA,0BAAmB,EAAC,GAAG,CAAC,CAAC;QACpC,IAAI,EAAE;YAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,2EAA2E;IAC3E,MAAM,CAAC,iBAAiB,CAAC,mCAAwB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC9D,OAAO,EAAE,qBAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/B,IAAI,EAAS,CAAC,CAAC,IAAI;YACnB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,SAAS,EAAI,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACnC,IAAI,EAAS,CAAC,CAAC,IAAI;gBACnB,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,QAAQ,EAAK,CAAC,CAAC,QAAQ;aACxB,CAAC,CAAC;SACJ,CAAC,CAAC;KACJ,CAAC,CAAC,CAAC;IAEJ,2EAA2E;IAC3E,MAAM,CAAC,iBAAiB,CAAC,iCAAsB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC7D,MAAM,MAAM,GAAG,qBAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAA2B,CAAC;QACtE,6DAA6D;QAC7D,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,CAAC,IAAI,+BAA+B,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAChF,CAAC;QACH,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtC,OAAO;YACL,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,QAAQ;SACT,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}
@@ -41,6 +41,12 @@ interface Hit {
41
41
  interface Output {
42
42
  query: string;
43
43
  hits: Hit[];
44
+ /** Set when the docs corpus could not be located at runtime (e.g. a build
45
+ * skipped `copy-embedded-assets.js` and the clone fallback paths don't
46
+ * resolve). Optional + additive — existing consumers still see hits: [].
47
+ * An LLM that branches on this can tell "corpus missing" apart from
48
+ * "no hits for this query". */
49
+ errorCode?: "docs_corpus_not_found";
44
50
  }
45
51
  export declare function findDocsRoot(): string | null;
46
52
  export declare function loadDocsCorpus(force?: boolean): DocPage[];
@@ -56,6 +56,8 @@ const InputSchema = zod_1.z.object({
56
56
  max_results: zod_1.z.number().int().min(1).max(20).default(5),
57
57
  });
58
58
  let cache = null;
59
+ // Module-level guard so the corpus-missing warn fires once per process.
60
+ let warnedMissingCorpus = false;
59
61
  function findDocsRoot() {
60
62
  const candidates = [
61
63
  // Env override wins (tests + power-users)
@@ -184,7 +186,17 @@ exports.docsTool = {
184
186
  async handler(input) {
185
187
  const corpus = loadDocsCorpus();
186
188
  if (corpus.length === 0) {
187
- return { query: input.query, hits: [] };
189
+ // The corpus is missing AND the find-roots probe came up empty.
190
+ // Surface a machine-parseable signal AND log once to stderr so a
191
+ // regression in copy-embedded-assets.js is visible to operators.
192
+ if (!warnedMissingCorpus) {
193
+ warnedMissingCorpus = true;
194
+ process.stderr.write("[agenttrust] WARN agenttrust_docs: docs corpus not found at runtime. " +
195
+ "Set MCP_DOCS_DIR, re-run the build (scripts/copy-embedded-assets.js), " +
196
+ "or verify the install path includes dist/embedded-docs/. " +
197
+ "Returning empty hits.\n");
198
+ }
199
+ return { query: input.query, hits: [], errorCode: "docs_corpus_not_found" };
188
200
  }
189
201
  const ranked = [];
190
202
  for (const page of corpus) {
@@ -1 +1 @@
1
- {"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/tools/discovery/docs.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/tools/discovery/docs.ts"],"names":[],"mappings":"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"}
@@ -25,6 +25,11 @@ interface Output {
25
25
  content: string;
26
26
  fallback?: string;
27
27
  servicesReadme?: string;
28
+ /** Set when the docs corpus can't be located at runtime and `content`
29
+ * is the literal "(no walkthrough bundled for ...)" placeholder. Lets
30
+ * an LLM agent distinguish a real walkthrough from a missing-asset
31
+ * placeholder. Additive + optional — existing consumers keep working. */
32
+ errorCode?: "walkthrough_not_bundled";
28
33
  }
29
34
  export declare const facilitatorWalkthroughTool: Tool<Input, Output>;
30
35
  export {};
@@ -125,16 +125,27 @@ exports.facilitatorWalkthroughTool = {
125
125
  if (content && services)
126
126
  break;
127
127
  }
128
+ // Track whether the doc body is a real walkthrough or a missing-asset
129
+ // placeholder. The string content is preserved for human readers; the
130
+ // errorCode below lets an LLM agent distinguish the two cases.
131
+ let contentResolved = !!content;
128
132
  if (!content)
129
133
  content = `(no walkthrough bundled for ${docRel})`;
130
134
  const out = {
131
135
  name: input.name,
132
- matched,
136
+ // If the docs corpus couldn't be located, the placeholder above is
137
+ // surfaced and `matched` is set to false regardless of the adapter
138
+ // name lookup — so an LLM doesn't treat the placeholder as authoritative.
139
+ matched: matched && contentResolved,
133
140
  source: docRel,
134
141
  content,
135
142
  servicesReadme: services || undefined,
136
143
  };
137
- if (!matched) {
144
+ if (!contentResolved) {
145
+ out.errorCode = "walkthrough_not_bundled";
146
+ out.fallback = "Walkthrough asset not bundled at runtime (docs corpus missing). Content is a placeholder.";
147
+ }
148
+ else if (!matched) {
138
149
  out.fallback = "Unknown facilitator; returning the generic adapter guide.";
139
150
  }
140
151
  return out;
@@ -1 +1 @@
1
- {"version":3,"file":"facilitator-walkthrough.js","sourceRoot":"","sources":["../../../src/tools/discovery/facilitator-walkthrough.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"facilitator-walkthrough.js","sourceRoot":"","sources":["../../../src/tools/discovery/facilitator-walkthrough.ts"],"names":[],"mappings":"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"}
@@ -15,6 +15,7 @@ const get_quantu_reputation_1 = require("./read/get-quantu-reputation");
15
15
  const get_validation_attestation_1 = require("./read/get-validation-attestation");
16
16
  const list_facilitators_1 = require("./read/list-facilitators");
17
17
  const demo_state_1 = require("./read/demo-state");
18
+ const init_authority_1 = require("./write/init-authority");
18
19
  const init_policy_1 = require("./write/init-policy");
19
20
  const set_killswitch_1 = require("./write/set-killswitch");
20
21
  const request_validation_1 = require("./write/request-validation");
@@ -36,6 +37,7 @@ exports.READ_TOOLS = [
36
37
  demo_state_1.demoStateTool,
37
38
  ];
38
39
  exports.WRITE_TOOLS = [
40
+ init_authority_1.initAuthorityTool,
39
41
  init_policy_1.initPolicyTool,
40
42
  set_killswitch_1.setKillswitchTool,
41
43
  request_validation_1.requestValidationTool,
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,kDAA+D;AAC/D,wDAAkE;AAClE,8DAAqE;AACrE,0DAAmE;AACnE,sDAAiE;AACjE,8DAAqE;AACrE,wEAA0E;AAC1E,kFAAiF;AACjF,gEAAsE;AACtE,kDAA+D;AAE/D,qDAAiE;AACjE,2DAAoE;AACpE,mEAAwE;AACxE,yEAA2E;AAC3E,yDAAmE;AAEnE,2CAA8D;AAC9D,iFAAiF;AACjF,mEAA0E;AAE7D,QAAA,UAAU,GAA2B;IAChD,0BAAoD;IACpD,gCAAoD;IACpD,sCAAoD;IACpD,kCAAoD;IACpD,8BAAoD;IACpD,qCAAoD;IACpD,+CAAoD;IACpD,yDAAoD;IACpD,wCAAoD;IACpD,0BAAoD;CACrD,CAAC;AAEW,QAAA,WAAW,GAA2B;IACjD,4BAA6C;IAC7C,kCAA6C;IAC7C,0CAA6C;IAC7C,+CAA6C;IAC7C,gCAA6C;CAC9C,CAAC;AAEW,QAAA,eAAe,GAA2B;IACrD,eAAgD;IAChD,oDAAgD;IAChD,sCAAgD;CACjD,CAAC;AAEW,QAAA,SAAS,GAA2B;IAC/C,GAAG,kBAAU;IACb,GAAG,mBAAW;IACd,GAAG,uBAAe;CACnB,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,kDAA+D;AAC/D,wDAAkE;AAClE,8DAAqE;AACrE,0DAAmE;AACnE,sDAAiE;AACjE,8DAAqE;AACrE,wEAA0E;AAC1E,kFAAiF;AACjF,gEAAsE;AACtE,kDAA+D;AAE/D,2DAAoE;AACpE,qDAAiE;AACjE,2DAAoE;AACpE,mEAAwE;AACxE,yEAA2E;AAC3E,yDAAmE;AAEnE,2CAA8D;AAC9D,iFAAiF;AACjF,mEAA0E;AAE7D,QAAA,UAAU,GAA2B;IAChD,0BAAoD;IACpD,gCAAoD;IACpD,sCAAoD;IACpD,kCAAoD;IACpD,8BAAoD;IACpD,qCAAoD;IACpD,+CAAoD;IACpD,yDAAoD;IACpD,wCAAoD;IACpD,0BAAoD;CACrD,CAAC;AAEW,QAAA,WAAW,GAA2B;IACjD,kCAA6C;IAC7C,4BAA6C;IAC7C,kCAA6C;IAC7C,0CAA6C;IAC7C,+CAA6C;IAC7C,gCAA6C;CAC9C,CAAC;AAEW,QAAA,eAAe,GAA2B;IACrD,eAAgD;IAChD,oDAAgD;IAChD,sCAAgD;CACjD,CAAC;AAEW,QAAA,SAAS,GAA2B;IAC/C,GAAG,kBAAU;IACb,GAAG,mBAAW;IACd,GAAG,uBAAe;CACnB,CAAC"}