@teamnetwork-nz/mailstore-spe-mcp 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 (110) hide show
  1. package/README.md +360 -0
  2. package/dist/config/env.d.ts +14 -0
  3. package/dist/config/env.js +45 -0
  4. package/dist/config/env.js.map +1 -0
  5. package/dist/config/schema.d.ts +86 -0
  6. package/dist/config/schema.js +55 -0
  7. package/dist/config/schema.js.map +1 -0
  8. package/dist/index.d.ts +2 -0
  9. package/dist/index.js +60 -0
  10. package/dist/index.js.map +1 -0
  11. package/dist/logging/logger.d.ts +12 -0
  12. package/dist/logging/logger.js +80 -0
  13. package/dist/logging/logger.js.map +1 -0
  14. package/dist/mailstore/authentication.d.ts +7 -0
  15. package/dist/mailstore/authentication.js +15 -0
  16. package/dist/mailstore/authentication.js.map +1 -0
  17. package/dist/mailstore/capability-registry.d.ts +40 -0
  18. package/dist/mailstore/capability-registry.js +152 -0
  19. package/dist/mailstore/capability-registry.js.map +1 -0
  20. package/dist/mailstore/client.d.ts +33 -0
  21. package/dist/mailstore/client.js +274 -0
  22. package/dist/mailstore/client.js.map +1 -0
  23. package/dist/mailstore/encoder.d.ts +14 -0
  24. package/dist/mailstore/encoder.js +42 -0
  25. package/dist/mailstore/encoder.js.map +1 -0
  26. package/dist/mailstore/errors.d.ts +44 -0
  27. package/dist/mailstore/errors.js +49 -0
  28. package/dist/mailstore/errors.js.map +1 -0
  29. package/dist/mailstore/instance-resolver.d.ts +43 -0
  30. package/dist/mailstore/instance-resolver.js +143 -0
  31. package/dist/mailstore/instance-resolver.js.map +1 -0
  32. package/dist/mailstore/metadata.d.ts +21 -0
  33. package/dist/mailstore/metadata.js +50 -0
  34. package/dist/mailstore/metadata.js.map +1 -0
  35. package/dist/mailstore/operation-poller.d.ts +19 -0
  36. package/dist/mailstore/operation-poller.js +72 -0
  37. package/dist/mailstore/operation-poller.js.map +1 -0
  38. package/dist/mailstore/response-parser.d.ts +11 -0
  39. package/dist/mailstore/response-parser.js +66 -0
  40. package/dist/mailstore/response-parser.js.map +1 -0
  41. package/dist/mailstore/types.d.ts +79 -0
  42. package/dist/mailstore/types.js +6 -0
  43. package/dist/mailstore/types.js.map +1 -0
  44. package/dist/output/normalizers.d.ts +11 -0
  45. package/dist/output/normalizers.js +40 -0
  46. package/dist/output/normalizers.js.map +1 -0
  47. package/dist/output/tool-result.d.ts +30 -0
  48. package/dist/output/tool-result.js +24 -0
  49. package/dist/output/tool-result.js.map +1 -0
  50. package/dist/output/truncation.d.ts +17 -0
  51. package/dist/output/truncation.js +27 -0
  52. package/dist/output/truncation.js.map +1 -0
  53. package/dist/policy/access-mode.d.ts +16 -0
  54. package/dist/policy/access-mode.js +21 -0
  55. package/dist/policy/access-mode.js.map +1 -0
  56. package/dist/policy/confirmations.d.ts +24 -0
  57. package/dist/policy/confirmations.js +49 -0
  58. package/dist/policy/confirmations.js.map +1 -0
  59. package/dist/policy/redaction.d.ts +15 -0
  60. package/dist/policy/redaction.js +63 -0
  61. package/dist/policy/redaction.js.map +1 -0
  62. package/dist/policy/tool-policy.d.ts +15 -0
  63. package/dist/policy/tool-policy.js +2 -0
  64. package/dist/policy/tool-policy.js.map +1 -0
  65. package/dist/resources/health.d.ts +17 -0
  66. package/dist/resources/health.js +55 -0
  67. package/dist/resources/health.js.map +1 -0
  68. package/dist/resources/register-resources.d.ts +7 -0
  69. package/dist/resources/register-resources.js +37 -0
  70. package/dist/resources/register-resources.js.map +1 -0
  71. package/dist/server.d.ts +17 -0
  72. package/dist/server.js +62 -0
  73. package/dist/server.js.map +1 -0
  74. package/dist/tools/compliance.d.ts +6 -0
  75. package/dist/tools/compliance.js +96 -0
  76. package/dist/tools/compliance.js.map +1 -0
  77. package/dist/tools/instances.d.ts +4 -0
  78. package/dist/tools/instances.js +197 -0
  79. package/dist/tools/instances.js.map +1 -0
  80. package/dist/tools/jobs.d.ts +2 -0
  81. package/dist/tools/jobs.js +125 -0
  82. package/dist/tools/jobs.js.map +1 -0
  83. package/dist/tools/maintenance.d.ts +3 -0
  84. package/dist/tools/maintenance.js +22 -0
  85. package/dist/tools/maintenance.js.map +1 -0
  86. package/dist/tools/platform.d.ts +4 -0
  87. package/dist/tools/platform.js +134 -0
  88. package/dist/tools/platform.js.map +1 -0
  89. package/dist/tools/profiles.d.ts +2 -0
  90. package/dist/tools/profiles.js +140 -0
  91. package/dist/tools/profiles.js.map +1 -0
  92. package/dist/tools/raw-api.d.ts +16 -0
  93. package/dist/tools/raw-api.js +109 -0
  94. package/dist/tools/raw-api.js.map +1 -0
  95. package/dist/tools/register-tools.d.ts +14 -0
  96. package/dist/tools/register-tools.js +121 -0
  97. package/dist/tools/register-tools.js.map +1 -0
  98. package/dist/tools/smtp.d.ts +2 -0
  99. package/dist/tools/smtp.js +39 -0
  100. package/dist/tools/smtp.js.map +1 -0
  101. package/dist/tools/stores.d.ts +2 -0
  102. package/dist/tools/stores.js +116 -0
  103. package/dist/tools/stores.js.map +1 -0
  104. package/dist/tools/tool.d.ts +41 -0
  105. package/dist/tools/tool.js +33 -0
  106. package/dist/tools/tool.js.map +1 -0
  107. package/dist/tools/users.d.ts +2 -0
  108. package/dist/tools/users.js +266 -0
  109. package/dist/tools/users.js.map +1 -0
  110. package/package.json +52 -0
@@ -0,0 +1,79 @@
1
+ /** Values accepted as MailStore API arguments before form encoding. */
2
+ export type ApiArgument = string | number | boolean | null | undefined | ApiJson;
3
+ export type ApiJson = {
4
+ [key: string]: unknown;
5
+ } | unknown[];
6
+ /** The raw MailStore Administration/Management API response envelope (§8.2). */
7
+ export interface MailStoreResponse<T = unknown> {
8
+ /** null on success; an object or string on failure. Tolerates undocumented shapes. */
9
+ error: MailStoreApiError | string | null;
10
+ /** Present for long-running operations to be polled via /api/get-status. */
11
+ token: string | null;
12
+ statusVersion: number;
13
+ statusCode: string;
14
+ percentProgress: number | null;
15
+ statusText: string | null;
16
+ result: T | null;
17
+ logOutput: string | null;
18
+ }
19
+ export interface MailStoreApiError {
20
+ message?: string;
21
+ details?: string;
22
+ [key: string]: unknown;
23
+ }
24
+ /** Terminal MailStore status codes. Anything else (esp. "running") is non-terminal. */
25
+ export declare const TERMINAL_STATUS: Set<string>;
26
+ export declare function isTerminalStatus(statusCode: string): boolean;
27
+ /** An in-flight or completed MailStore operation, as surfaced by the client. */
28
+ export interface MailStoreOperation<T = unknown> {
29
+ functionName: string;
30
+ statusCode: string;
31
+ statusVersion: number;
32
+ token: string | null;
33
+ percentProgress: number | null;
34
+ statusText: string | null;
35
+ result: T | null;
36
+ logOutput: string | null;
37
+ /** True when statusCode is terminal. */
38
+ completed: boolean;
39
+ }
40
+ /** A completed operation (statusCode terminal). */
41
+ export interface MailStoreCompletedOperation<T = unknown> extends MailStoreOperation<T> {
42
+ completed: true;
43
+ }
44
+ /** Metadata describing one API function argument. */
45
+ export interface ApiFunctionArgument {
46
+ name: string;
47
+ type: string;
48
+ nullable: boolean;
49
+ }
50
+ /** Metadata describing one available API function. */
51
+ export interface ApiFunctionMetadata {
52
+ name: string;
53
+ arguments: ApiFunctionArgument[];
54
+ }
55
+ export interface RequestOptions {
56
+ signal?: AbortSignal;
57
+ timeoutMs?: number;
58
+ }
59
+ export interface InvokeOptions extends RequestOptions {
60
+ /** When true, treat the call as safe to retry on transient failures (read-only calls). */
61
+ retrySafe?: boolean;
62
+ }
63
+ export interface WaitOptions {
64
+ signal?: AbortSignal;
65
+ /** Overall operation timeout in ms (defaults to config operationTimeoutMs). */
66
+ operationTimeoutMs?: number;
67
+ /** Long-poll window in ms passed to get-status (defaults to config longPollTimeoutMs). */
68
+ longPollTimeoutMs?: number;
69
+ onProgress?: (op: MailStoreOperation) => void;
70
+ }
71
+ /** The client contract consumed by the tool layer. */
72
+ export interface IMailStoreClient {
73
+ getMetadata(options?: RequestOptions): Promise<ApiFunctionMetadata[]>;
74
+ invoke<T>(functionName: string, args?: Record<string, ApiArgument>, options?: InvokeOptions): Promise<MailStoreOperation<T>>;
75
+ waitForOperation<T>(operation: MailStoreOperation<T>, options?: WaitOptions): Promise<MailStoreCompletedOperation<T>>;
76
+ /** Convenience: invoke and wait for a terminal result, returning result payload. */
77
+ invokeAndWait<T>(functionName: string, args?: Record<string, ApiArgument>, options?: InvokeOptions & WaitOptions): Promise<T | null>;
78
+ ping(options?: RequestOptions): Promise<void>;
79
+ }
@@ -0,0 +1,6 @@
1
+ /** Terminal MailStore status codes. Anything else (esp. "running") is non-terminal. */
2
+ export const TERMINAL_STATUS = new Set(['succeeded', 'failed', 'canceled', 'cancelled']);
3
+ export function isTerminalStatus(statusCode) {
4
+ return TERMINAL_STATUS.has(statusCode.toLowerCase());
5
+ }
6
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mailstore/types.ts"],"names":[],"mappings":"AA0BA,uFAAuF;AACvF,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;AAEzF,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;AACvD,CAAC"}
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Normalisation helpers shared by tools. Values from the MailStore API are
3
+ * treated as untrusted `unknown` and narrowed defensively.
4
+ */
5
+ export declare function asRecord(value: unknown): Record<string, unknown>;
6
+ export declare function asArray(value: unknown): unknown[];
7
+ export declare function str(value: unknown): string | undefined;
8
+ export declare function num(value: unknown): number | undefined;
9
+ export declare function bool(value: unknown): boolean | undefined;
10
+ /** Pick the first present string among candidate keys. */
11
+ export declare function pickStr(rec: Record<string, unknown>, keys: string[]): string | undefined;
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Normalisation helpers shared by tools. Values from the MailStore API are
3
+ * treated as untrusted `unknown` and narrowed defensively.
4
+ */
5
+ export function asRecord(value) {
6
+ return value && typeof value === 'object' && !Array.isArray(value)
7
+ ? value
8
+ : {};
9
+ }
10
+ export function asArray(value) {
11
+ if (Array.isArray(value))
12
+ return value;
13
+ if (value && typeof value === 'object') {
14
+ // Some list endpoints wrap the array in a single property.
15
+ for (const v of Object.values(value)) {
16
+ if (Array.isArray(v))
17
+ return v;
18
+ }
19
+ }
20
+ return [];
21
+ }
22
+ export function str(value) {
23
+ return typeof value === 'string' && value.length > 0 ? value : undefined;
24
+ }
25
+ export function num(value) {
26
+ return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
27
+ }
28
+ export function bool(value) {
29
+ return typeof value === 'boolean' ? value : undefined;
30
+ }
31
+ /** Pick the first present string among candidate keys. */
32
+ export function pickStr(rec, keys) {
33
+ for (const k of keys) {
34
+ const v = str(rec[k]);
35
+ if (v !== undefined)
36
+ return v;
37
+ }
38
+ return undefined;
39
+ }
40
+ //# sourceMappingURL=normalizers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"normalizers.js","sourceRoot":"","sources":["../../src/output/normalizers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,2DAA2D;QAC3D,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAgC,CAAC,EAAE,CAAC;YAChE,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,OAAO,CAAC,GAA4B,EAAE,IAAc;IAClE,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}
@@ -0,0 +1,30 @@
1
+ /** Bounded, structured tool result (§16). */
2
+ export interface ToolResult<T> {
3
+ summary: string;
4
+ data: T;
5
+ warnings?: string[];
6
+ truncated?: boolean;
7
+ totalCount?: number;
8
+ returnedCount?: number;
9
+ }
10
+ export interface BuildResultOptions<T> {
11
+ summary: string;
12
+ data: T;
13
+ warnings?: string[];
14
+ truncated?: boolean;
15
+ totalCount?: number;
16
+ returnedCount?: number;
17
+ }
18
+ /** Build a ToolResult, omitting empty optional fields. */
19
+ export declare function buildResult<T>(opts: BuildResultOptions<T>): ToolResult<T>;
20
+ /**
21
+ * Serialise a ToolResult into an MCP tool-response content payload. The entire
22
+ * result is passed through secret redaction before serialisation, so nothing
23
+ * sensitive can leave the process even if the API returned it unexpectedly.
24
+ */
25
+ export declare function toMcpContent<T>(result: ToolResult<T>): {
26
+ content: Array<{
27
+ type: 'text';
28
+ text: string;
29
+ }>;
30
+ };
@@ -0,0 +1,24 @@
1
+ import { redact } from '../policy/redaction.js';
2
+ /** Build a ToolResult, omitting empty optional fields. */
3
+ export function buildResult(opts) {
4
+ const result = { summary: opts.summary, data: opts.data };
5
+ if (opts.warnings && opts.warnings.length > 0)
6
+ result.warnings = opts.warnings;
7
+ if (opts.truncated)
8
+ result.truncated = true;
9
+ if (opts.totalCount !== undefined)
10
+ result.totalCount = opts.totalCount;
11
+ if (opts.returnedCount !== undefined)
12
+ result.returnedCount = opts.returnedCount;
13
+ return result;
14
+ }
15
+ /**
16
+ * Serialise a ToolResult into an MCP tool-response content payload. The entire
17
+ * result is passed through secret redaction before serialisation, so nothing
18
+ * sensitive can leave the process even if the API returned it unexpectedly.
19
+ */
20
+ export function toMcpContent(result) {
21
+ const safe = redact(result);
22
+ return { content: [{ type: 'text', text: JSON.stringify(safe, null, 2) }] };
23
+ }
24
+ //# sourceMappingURL=tool-result.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-result.js","sourceRoot":"","sources":["../../src/output/tool-result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAqBhD,0DAA0D;AAC1D,MAAM,UAAU,WAAW,CAAI,IAA2B;IACxD,MAAM,MAAM,GAAkB,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IACzE,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC/E,IAAI,IAAI,CAAC,SAAS;QAAE,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;IAC5C,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;QAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACvE,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS;QAAE,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;IAChF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAI,MAAqB;IAGnD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC9E,CAAC"}
@@ -0,0 +1,17 @@
1
+ export interface TruncationResult<T> {
2
+ items: T[];
3
+ truncated: boolean;
4
+ totalCount: number;
5
+ returnedCount: number;
6
+ }
7
+ /**
8
+ * Apply an optional client-side search filter and then a hard item limit
9
+ * (MailStore functions rarely paginate natively; §16.1). `limit` is clamped to
10
+ * `maxItems` so a caller can never request an unbounded result.
11
+ */
12
+ export declare function limitItems<T>(items: T[], opts: {
13
+ limit?: number;
14
+ maxItems: number;
15
+ }): TruncationResult<T>;
16
+ /** Case-insensitive substring filter across selected string fields of each item. */
17
+ export declare function searchFilter<T extends Record<string, unknown>>(items: T[], search: string | undefined, fields: Array<keyof T>): T[];
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Apply an optional client-side search filter and then a hard item limit
3
+ * (MailStore functions rarely paginate natively; §16.1). `limit` is clamped to
4
+ * `maxItems` so a caller can never request an unbounded result.
5
+ */
6
+ export function limitItems(items, opts) {
7
+ const totalCount = items.length;
8
+ const effectiveLimit = Math.min(opts.limit ?? opts.maxItems, opts.maxItems);
9
+ const returned = items.slice(0, effectiveLimit);
10
+ return {
11
+ items: returned,
12
+ truncated: returned.length < totalCount,
13
+ totalCount,
14
+ returnedCount: returned.length,
15
+ };
16
+ }
17
+ /** Case-insensitive substring filter across selected string fields of each item. */
18
+ export function searchFilter(items, search, fields) {
19
+ if (!search || search.trim().length === 0)
20
+ return items;
21
+ const needle = search.trim().toLowerCase();
22
+ return items.filter((item) => fields.some((f) => {
23
+ const v = item[f];
24
+ return typeof v === 'string' && v.toLowerCase().includes(needle);
25
+ }));
26
+ }
27
+ //# sourceMappingURL=truncation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"truncation.js","sourceRoot":"","sources":["../../src/output/truncation.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,KAAU,EACV,IAA0C;IAE1C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;IAChC,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAChD,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,SAAS,EAAE,QAAQ,CAAC,MAAM,GAAG,UAAU;QACvC,UAAU;QACV,aAAa,EAAE,QAAQ,CAAC,MAAM;KAC/B,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,YAAY,CAC1B,KAAU,EACV,MAA0B,EAC1B,MAAsB;IAEtB,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QAChB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnE,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}
@@ -0,0 +1,16 @@
1
+ import { type AccessMode } from '../config/schema.js';
2
+ import type { ToolPolicy } from './tool-policy.js';
3
+ /** True when `current` mode satisfies the tool's minimum required mode. */
4
+ export declare function modeSatisfies(current: AccessMode, required: AccessMode): boolean;
5
+ /**
6
+ * Decide whether a tool should be registered given the current configuration.
7
+ *
8
+ * Read-only mode registers only read tools (§15.5) — mutating tools are not
9
+ * registered at all rather than registered-and-denied. Destructive tools are
10
+ * only registered when the destructive flag is enabled, keeping the exposed
11
+ * tool set to what is actually usable.
12
+ */
13
+ export declare function shouldRegisterTool(policy: ToolPolicy, opts: {
14
+ accessMode: AccessMode;
15
+ allowDestructive: boolean;
16
+ }): boolean;
@@ -0,0 +1,21 @@
1
+ import { ACCESS_MODE_RANK } from '../config/schema.js';
2
+ /** True when `current` mode satisfies the tool's minimum required mode. */
3
+ export function modeSatisfies(current, required) {
4
+ return ACCESS_MODE_RANK[current] >= ACCESS_MODE_RANK[required];
5
+ }
6
+ /**
7
+ * Decide whether a tool should be registered given the current configuration.
8
+ *
9
+ * Read-only mode registers only read tools (§15.5) — mutating tools are not
10
+ * registered at all rather than registered-and-denied. Destructive tools are
11
+ * only registered when the destructive flag is enabled, keeping the exposed
12
+ * tool set to what is actually usable.
13
+ */
14
+ export function shouldRegisterTool(policy, opts) {
15
+ if (!modeSatisfies(opts.accessMode, policy.minimumMode))
16
+ return false;
17
+ if (policy.requiresDestructiveFlag && !opts.allowDestructive)
18
+ return false;
19
+ return true;
20
+ }
21
+ //# sourceMappingURL=access-mode.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"access-mode.js","sourceRoot":"","sources":["../../src/policy/access-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAmB,MAAM,qBAAqB,CAAC;AAGxE,2EAA2E;AAC3E,MAAM,UAAU,aAAa,CAAC,OAAmB,EAAE,QAAoB;IACrE,OAAO,gBAAgB,CAAC,OAAO,CAAC,IAAI,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAkB,EAClB,IAA2D;IAE3D,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC;IACtE,IAAI,MAAM,CAAC,uBAAuB,IAAI,CAAC,IAAI,CAAC,gBAAgB;QAAE,OAAO,KAAK,CAAC;IAC3E,OAAO,IAAI,CAAC;AACd,CAAC"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Assert that `provided` equals the `expected` confirmation exactly. Throws
3
+ * CONFIRMATION_REQUIRED when nothing was supplied, or CONFIRMATION_MISMATCH when
4
+ * it does not match. On success returns void.
5
+ */
6
+ export declare function assertConfirmation(expected: string, provided: string | undefined): void;
7
+ export declare const confirmations: {
8
+ startInstance: (instanceID: string) => string;
9
+ stopInstance: (instanceID: string) => string;
10
+ restartInstance: (instanceID: string) => string;
11
+ createUser: (userName: string, instanceID: string) => string;
12
+ updateUser: (userName: string, instanceID: string) => string;
13
+ setUserPassword: (userName: string, instanceID: string) => string;
14
+ deleteUser: (userName: string, instanceID: string) => string;
15
+ syncUsers: (instanceID: string) => string;
16
+ runProfile: (profileId: number, instanceID: string) => string;
17
+ runJob: (jobId: number, instanceID: string) => string;
18
+ cancelJob: (jobId: number, instanceID: string) => string;
19
+ verifyStore: (storeId: number, instanceID: string) => string;
20
+ verifyAllStores: (instanceID: string) => string;
21
+ refreshStoreStatistics: (instanceID: string) => string;
22
+ testSmtp: (instanceID: string) => string;
23
+ changeRetention: (instanceID: string) => string;
24
+ };
@@ -0,0 +1,49 @@
1
+ import { Errors } from '../mailstore/errors.js';
2
+ /**
3
+ * Exact confirmation-string enforcement (§15.3).
4
+ *
5
+ * Confirmation strings are generated from resolved server state (the exact
6
+ * instanceID and the affected object name/id), not from untrusted input. Generic
7
+ * confirmations ("yes", "confirm", "proceed") are never accepted. The caller
8
+ * must supply a string that matches exactly.
9
+ */
10
+ const GENERIC = new Set(['yes', 'y', 'confirm', 'confirmed', 'proceed', 'ok', 'true']);
11
+ /**
12
+ * Assert that `provided` equals the `expected` confirmation exactly. Throws
13
+ * CONFIRMATION_REQUIRED when nothing was supplied, or CONFIRMATION_MISMATCH when
14
+ * it does not match. On success returns void.
15
+ */
16
+ export function assertConfirmation(expected, provided) {
17
+ if (provided === undefined || provided.trim().length === 0) {
18
+ throw Errors.confirmationRequired('This action requires confirmation. Repeat the call with the exact confirmation string.', { requiredConfirmation: expected });
19
+ }
20
+ const normalizedProvided = provided.trim();
21
+ if (GENERIC.has(normalizedProvided.toLowerCase())) {
22
+ throw Errors.confirmationMismatch('Generic confirmations are not accepted. Supply the exact confirmation string.', { requiredConfirmation: expected });
23
+ }
24
+ if (normalizedProvided !== expected) {
25
+ throw Errors.confirmationMismatch('The confirmation string did not match exactly.', {
26
+ requiredConfirmation: expected,
27
+ });
28
+ }
29
+ }
30
+ // ── Confirmation string builders (single source of truth) ────────────────────
31
+ export const confirmations = {
32
+ startInstance: (instanceID) => `START ${instanceID}`,
33
+ stopInstance: (instanceID) => `STOP ${instanceID}`,
34
+ restartInstance: (instanceID) => `RESTART ${instanceID}`,
35
+ createUser: (userName, instanceID) => `CREATE USER ${userName} IN ${instanceID}`,
36
+ updateUser: (userName, instanceID) => `UPDATE USER ${userName} IN ${instanceID}`,
37
+ setUserPassword: (userName, instanceID) => `SET PASSWORD FOR ${userName} IN ${instanceID}`,
38
+ deleteUser: (userName, instanceID) => `DELETE USER ${userName} FROM ${instanceID}`,
39
+ syncUsers: (instanceID) => `SYNC USERS IN ${instanceID}`,
40
+ runProfile: (profileId, instanceID) => `RUN PROFILE ${profileId} IN ${instanceID}`,
41
+ runJob: (jobId, instanceID) => `RUN JOB ${jobId} IN ${instanceID}`,
42
+ cancelJob: (jobId, instanceID) => `CANCEL JOB ${jobId} IN ${instanceID}`,
43
+ verifyStore: (storeId, instanceID) => `VERIFY STORE ${storeId} IN ${instanceID}`,
44
+ verifyAllStores: (instanceID) => `VERIFY ALL STORES IN ${instanceID}`,
45
+ refreshStoreStatistics: (instanceID) => `REFRESH STORE STATISTICS IN ${instanceID}`,
46
+ testSmtp: (instanceID) => `TEST SMTP IN ${instanceID}`,
47
+ changeRetention: (instanceID) => `CHANGE RETENTION POLICIES IN ${instanceID}`,
48
+ };
49
+ //# sourceMappingURL=confirmations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"confirmations.js","sourceRoot":"","sources":["../../src/policy/confirmations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD;;;;;;;GAOG;AAEH,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvF;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,QAA4B;IAC/E,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,MAAM,CAAC,oBAAoB,CAC/B,wFAAwF,EACxF,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CACnC,CAAC;IACJ,CAAC;IACD,MAAM,kBAAkB,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC3C,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAClD,MAAM,MAAM,CAAC,oBAAoB,CAC/B,+EAA+E,EAC/E,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CACnC,CAAC;IACJ,CAAC;IACD,IAAI,kBAAkB,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,MAAM,CAAC,oBAAoB,CAAC,gDAAgD,EAAE;YAClF,oBAAoB,EAAE,QAAQ;SAC/B,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,gFAAgF;AAEhF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,aAAa,EAAE,CAAC,UAAkB,EAAE,EAAE,CAAC,SAAS,UAAU,EAAE;IAC5D,YAAY,EAAE,CAAC,UAAkB,EAAE,EAAE,CAAC,QAAQ,UAAU,EAAE;IAC1D,eAAe,EAAE,CAAC,UAAkB,EAAE,EAAE,CAAC,WAAW,UAAU,EAAE;IAChE,UAAU,EAAE,CAAC,QAAgB,EAAE,UAAkB,EAAE,EAAE,CAAC,eAAe,QAAQ,OAAO,UAAU,EAAE;IAChG,UAAU,EAAE,CAAC,QAAgB,EAAE,UAAkB,EAAE,EAAE,CAAC,eAAe,QAAQ,OAAO,UAAU,EAAE;IAChG,eAAe,EAAE,CAAC,QAAgB,EAAE,UAAkB,EAAE,EAAE,CAAC,oBAAoB,QAAQ,OAAO,UAAU,EAAE;IAC1G,UAAU,EAAE,CAAC,QAAgB,EAAE,UAAkB,EAAE,EAAE,CAAC,eAAe,QAAQ,SAAS,UAAU,EAAE;IAClG,SAAS,EAAE,CAAC,UAAkB,EAAE,EAAE,CAAC,iBAAiB,UAAU,EAAE;IAChE,UAAU,EAAE,CAAC,SAAiB,EAAE,UAAkB,EAAE,EAAE,CAAC,eAAe,SAAS,OAAO,UAAU,EAAE;IAClG,MAAM,EAAE,CAAC,KAAa,EAAE,UAAkB,EAAE,EAAE,CAAC,WAAW,KAAK,OAAO,UAAU,EAAE;IAClF,SAAS,EAAE,CAAC,KAAa,EAAE,UAAkB,EAAE,EAAE,CAAC,cAAc,KAAK,OAAO,UAAU,EAAE;IACxF,WAAW,EAAE,CAAC,OAAe,EAAE,UAAkB,EAAE,EAAE,CAAC,gBAAgB,OAAO,OAAO,UAAU,EAAE;IAChG,eAAe,EAAE,CAAC,UAAkB,EAAE,EAAE,CAAC,wBAAwB,UAAU,EAAE;IAC7E,sBAAsB,EAAE,CAAC,UAAkB,EAAE,EAAE,CAAC,+BAA+B,UAAU,EAAE;IAC3F,QAAQ,EAAE,CAAC,UAAkB,EAAE,EAAE,CAAC,gBAAgB,UAAU,EAAE;IAC9D,eAAe,EAAE,CAAC,UAAkB,EAAE,EAAE,CAAC,gCAAgC,UAAU,EAAE;CACtF,CAAC"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Recursive secret redaction for logs and MCP responses.
3
+ *
4
+ * Any object key whose name resembles a credential is replaced with a marker,
5
+ * regardless of nesting depth. This is applied to everything that leaves the
6
+ * process as a log record or as tool output, so that secrets returned by the
7
+ * MailStore API (or supplied as arguments) are never surfaced.
8
+ */
9
+ export declare function isSensitiveKey(key: string): boolean;
10
+ /**
11
+ * Return a deep copy of `value` with sensitive fields replaced by a marker.
12
+ * Handles nested objects and arrays. Non-plain values are returned as-is.
13
+ * `maxDepth` guards against pathological/cyclic structures.
14
+ */
15
+ export declare function redact(value: unknown, maxDepth?: number): unknown;
@@ -0,0 +1,63 @@
1
+ /**
2
+ * Recursive secret redaction for logs and MCP responses.
3
+ *
4
+ * Any object key whose name resembles a credential is replaced with a marker,
5
+ * regardless of nesting depth. This is applied to everything that leaves the
6
+ * process as a log record or as tool output, so that secrets returned by the
7
+ * MailStore API (or supplied as arguments) are never surfaced.
8
+ */
9
+ const REDACTED = '[REDACTED]';
10
+ /** Key-name fragments that indicate a sensitive value (case-insensitive). */
11
+ const SENSITIVE_KEY_PATTERNS = [
12
+ /password/i,
13
+ /passphrase/i,
14
+ /secret/i,
15
+ /token/i,
16
+ /authorization/i,
17
+ /apipassword/i,
18
+ /api[-_]?key/i,
19
+ /\bkey\b/i,
20
+ /encryptionkey/i,
21
+ /privatekey/i,
22
+ /certificate/i,
23
+ /credential/i,
24
+ ];
25
+ /** Keys that are safe despite matching a broad pattern (avoid over-redaction). */
26
+ const ALLOWLIST = new Set([
27
+ 'publicKey',
28
+ 'keyCount',
29
+ 'keyName',
30
+ 'keyType',
31
+ 'licenseKeyType',
32
+ ]);
33
+ export function isSensitiveKey(key) {
34
+ if (ALLOWLIST.has(key))
35
+ return false;
36
+ return SENSITIVE_KEY_PATTERNS.some((re) => re.test(key));
37
+ }
38
+ /**
39
+ * Return a deep copy of `value` with sensitive fields replaced by a marker.
40
+ * Handles nested objects and arrays. Non-plain values are returned as-is.
41
+ * `maxDepth` guards against pathological/cyclic structures.
42
+ */
43
+ export function redact(value, maxDepth = 8) {
44
+ return redactInner(value, maxDepth, new WeakSet());
45
+ }
46
+ function redactInner(value, depth, seen) {
47
+ if (value === null || typeof value !== 'object')
48
+ return value;
49
+ if (depth <= 0)
50
+ return '[TRUNCATED]';
51
+ if (seen.has(value))
52
+ return '[CIRCULAR]';
53
+ seen.add(value);
54
+ if (Array.isArray(value)) {
55
+ return value.map((v) => redactInner(v, depth - 1, seen));
56
+ }
57
+ const out = {};
58
+ for (const [k, v] of Object.entries(value)) {
59
+ out[k] = isSensitiveKey(k) ? REDACTED : redactInner(v, depth - 1, seen);
60
+ }
61
+ return out;
62
+ }
63
+ //# sourceMappingURL=redaction.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"redaction.js","sourceRoot":"","sources":["../../src/policy/redaction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,6EAA6E;AAC7E,MAAM,sBAAsB,GAAa;IACvC,WAAW;IACX,aAAa;IACb,SAAS;IACT,QAAQ;IACR,gBAAgB;IAChB,cAAc;IACd,cAAc;IACd,UAAU;IACV,gBAAgB;IAChB,aAAa;IACb,cAAc;IACd,aAAa;CACd,CAAC;AAEF,kFAAkF;AAClF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAS;IAChC,WAAW;IACX,UAAU;IACV,SAAS;IACT,SAAS;IACT,gBAAgB;CACjB,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc,EAAE,QAAQ,GAAG,CAAC;IACjD,OAAO,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,OAAO,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,WAAW,CAAC,KAAc,EAAE,KAAa,EAAE,IAAqB;IACvE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,aAAa,CAAC;IACrC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAe,CAAC;QAAE,OAAO,YAAY,CAAC;IACnD,IAAI,CAAC,GAAG,CAAC,KAAe,CAAC,CAAC;IAE1B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
@@ -0,0 +1,15 @@
1
+ import type { AccessMode } from '../config/schema.js';
2
+ /** Risk classification for a tool (§15.1). Not inferred from function names. */
3
+ export type ToolRisk = 'read' | 'operational' | 'mutating' | 'destructive' | 'credential' | 'filesystem';
4
+ /** Static safety policy attached to every tool (§15.2). */
5
+ export interface ToolPolicy {
6
+ /** Minimum access mode required for the tool to be registered/usable. */
7
+ minimumMode: AccessMode;
8
+ risk: ToolRisk;
9
+ /** Requires an exact confirmation string generated from resolved state. */
10
+ requiresConfirmation: boolean;
11
+ /** Additionally requires MCP_ALLOW_DESTRUCTIVE=true. */
12
+ requiresDestructiveFlag?: boolean;
13
+ /** Whether the tool may target multiple objects/instances at once. Always false in phase one. */
14
+ permitsBulkTargets: boolean;
15
+ }
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=tool-policy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-policy.js","sourceRoot":"","sources":["../../src/policy/tool-policy.ts"],"names":[],"mappings":""}
@@ -0,0 +1,17 @@
1
+ import type { ToolContext } from '../tools/tool.js';
2
+ export interface HealthReport {
3
+ status: 'healthy' | 'degraded' | 'unhealthy';
4
+ mailStoreReachable: boolean;
5
+ authenticated: boolean;
6
+ tlsVerified: boolean;
7
+ version?: string;
8
+ metadataLoaded: boolean;
9
+ instanceCacheAgeSeconds?: number;
10
+ accessMode: string;
11
+ }
12
+ /**
13
+ * Build the health report. Never includes username or password. Probes the
14
+ * server with Ping (which also exercises authentication) and reports degraded
15
+ * state when TLS verification is disabled.
16
+ */
17
+ export declare function buildHealth(ctx: ToolContext): Promise<HealthReport>;
@@ -0,0 +1,55 @@
1
+ import { asRecord, pickStr } from '../output/normalizers.js';
2
+ /**
3
+ * Build the health report. Never includes username or password. Probes the
4
+ * server with Ping (which also exercises authentication) and reports degraded
5
+ * state when TLS verification is disabled.
6
+ */
7
+ export async function buildHealth(ctx) {
8
+ const metadataLoaded = ctx.registry.functionCount > 0;
9
+ let mailStoreReachable = false;
10
+ let authenticated = false;
11
+ let version;
12
+ try {
13
+ await ctx.client.ping();
14
+ mailStoreReachable = true;
15
+ authenticated = true;
16
+ }
17
+ catch (err) {
18
+ // Distinguish auth failure (reachable but rejected) from unreachable.
19
+ const code = err.code;
20
+ if (code === 'AUTHENTICATION_FAILED' || code === 'AUTHORIZATION_FAILED') {
21
+ mailStoreReachable = true;
22
+ authenticated = false;
23
+ }
24
+ }
25
+ if (mailStoreReachable && authenticated) {
26
+ try {
27
+ const env = asRecord(await ctx.client.invokeAndWait('GetEnvironmentInfo', {}, { retrySafe: true }));
28
+ version = pickStr(env, ['version', 'productVersion', 'mailStoreVersion']);
29
+ }
30
+ catch {
31
+ // version is best-effort
32
+ }
33
+ }
34
+ const tlsVerified = ctx.config.verifyTls;
35
+ let status;
36
+ if (!mailStoreReachable || !authenticated || !metadataLoaded) {
37
+ status = 'unhealthy';
38
+ }
39
+ else if (!tlsVerified) {
40
+ status = 'degraded';
41
+ }
42
+ else {
43
+ status = 'healthy';
44
+ }
45
+ return {
46
+ status,
47
+ mailStoreReachable,
48
+ authenticated,
49
+ tlsVerified,
50
+ ...(version !== undefined ? { version } : {}),
51
+ metadataLoaded,
52
+ accessMode: ctx.config.accessMode,
53
+ };
54
+ }
55
+ //# sourceMappingURL=health.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/resources/health.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAa7D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAgB;IAChD,MAAM,cAAc,GAAG,GAAG,CAAC,QAAQ,CAAC,aAAa,GAAG,CAAC,CAAC;IACtD,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAC/B,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,OAA2B,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACxB,kBAAkB,GAAG,IAAI,CAAC;QAC1B,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,sEAAsE;QACtE,MAAM,IAAI,GAAI,GAAyB,CAAC,IAAI,CAAC;QAC7C,IAAI,IAAI,KAAK,uBAAuB,IAAI,IAAI,KAAK,sBAAsB,EAAE,CAAC;YACxE,kBAAkB,GAAG,IAAI,CAAC;YAC1B,aAAa,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IAED,IAAI,kBAAkB,IAAI,aAAa,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,aAAa,CAAU,oBAAoB,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC7G,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,CAAC,CAAC;QAC5E,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;IACzC,IAAI,MAA8B,CAAC;IACnC,IAAI,CAAC,kBAAkB,IAAI,CAAC,aAAa,IAAI,CAAC,cAAc,EAAE,CAAC;QAC7D,MAAM,GAAG,WAAW,CAAC;IACvB,CAAC;SAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACxB,MAAM,GAAG,UAAU,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,SAAS,CAAC;IACrB,CAAC;IAED,OAAO;QACL,MAAM;QACN,kBAAkB;QAClB,aAAa;QACb,WAAW;QACX,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,cAAc;QACd,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU;KAClC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,7 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { ToolContext } from '../tools/tool.js';
3
+ /**
4
+ * Register read-only MCP resources. Each is a safe, bounded view of platform
5
+ * state. None expose credentials.
6
+ */
7
+ export declare function registerResources(server: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,37 @@
1
+ import { redact } from '../policy/redaction.js';
2
+ import { buildHealth } from './health.js';
3
+ /** JSON resource content helper. */
4
+ function jsonResource(uri, value) {
5
+ return {
6
+ contents: [{ uri, mimeType: 'application/json', text: JSON.stringify(redact(value), null, 2) }],
7
+ };
8
+ }
9
+ /**
10
+ * Register read-only MCP resources. Each is a safe, bounded view of platform
11
+ * state. None expose credentials.
12
+ */
13
+ export function registerResources(server, ctx) {
14
+ server.resource('mailstore-health', 'mailstore://health', async (uri) => {
15
+ return jsonResource(uri.href, await buildHealth(ctx));
16
+ });
17
+ server.resource('mailstore-environment', 'mailstore://environment', async (uri) => {
18
+ const env = await ctx.client.invokeAndWait('GetEnvironmentInfo', {}, { retrySafe: true });
19
+ return jsonResource(uri.href, env);
20
+ });
21
+ server.resource('mailstore-service-status', 'mailstore://service-status', async (uri) => {
22
+ const status = await ctx.client.invokeAndWait('GetServiceStatus', {}, { retrySafe: true });
23
+ return jsonResource(uri.href, status);
24
+ });
25
+ server.resource('mailstore-instances', 'mailstore://instances', async (uri) => {
26
+ const instances = (await ctx.resolver.list('*', true)).map(({ raw: _raw, ...rest }) => rest);
27
+ return jsonResource(uri.href, { count: instances.length, instances });
28
+ });
29
+ server.resource('mailstore-capabilities', 'mailstore://capabilities', async (uri) => {
30
+ const fns = await ctx.metadata.get();
31
+ return jsonResource(uri.href, {
32
+ functionCount: fns.length,
33
+ functions: fns.map((f) => f.name).sort(),
34
+ });
35
+ });
36
+ }
37
+ //# sourceMappingURL=register-resources.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"register-resources.js","sourceRoot":"","sources":["../../src/resources/register-resources.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,oCAAoC;AACpC,SAAS,YAAY,CAAC,GAAW,EAAE,KAAc;IAC/C,OAAO;QACL,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KAChG,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,GAAgB;IACnE,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACtE,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,QAAQ,CAAC,uBAAuB,EAAE,yBAAyB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAChF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,aAAa,CAAU,oBAAoB,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnG,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,QAAQ,CAAC,0BAA0B,EAAE,4BAA4B,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACtF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,aAAa,CAAU,kBAAkB,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpG,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,QAAQ,CAAC,qBAAqB,EAAE,uBAAuB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5E,MAAM,SAAS,GAAG,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QAC7F,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,QAAQ,CAAC,wBAAwB,EAAE,0BAA0B,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAClF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QACrC,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE;YAC5B,aAAa,EAAE,GAAG,CAAC,MAAM;YACzB,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;SACzC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}