@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,17 @@
1
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { Logger } from 'pino';
3
+ import type { AppConfig } from './config/schema.js';
4
+ import { registerTools } from './tools/register-tools.js';
5
+ import type { ToolContext } from './tools/tool.js';
6
+ export interface BuiltServer {
7
+ server: McpServer;
8
+ ctx: ToolContext;
9
+ registration: ReturnType<typeof registerTools>;
10
+ close: () => Promise<void>;
11
+ }
12
+ /**
13
+ * Build the MCP server: construct the client and supporting services, validate
14
+ * capabilities against live metadata (fails if essential functions are missing),
15
+ * then register the eligible tools and resources.
16
+ */
17
+ export declare function buildServer(config: AppConfig, logger: Logger): Promise<BuiltServer>;
package/dist/server.js ADDED
@@ -0,0 +1,62 @@
1
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import { MailStoreClient } from './mailstore/client.js';
3
+ import { MetadataService } from './mailstore/metadata.js';
4
+ import { CapabilityRegistry } from './mailstore/capability-registry.js';
5
+ import { InstanceResolver } from './mailstore/instance-resolver.js';
6
+ import { registerTools } from './tools/register-tools.js';
7
+ import { registerResources } from './resources/register-resources.js';
8
+ const SERVER_INFO = {
9
+ name: '@teamnetwork-nz/mailstore-spe-mcp',
10
+ version: '0.1.0',
11
+ };
12
+ /**
13
+ * Build the MCP server: construct the client and supporting services, validate
14
+ * capabilities against live metadata (fails if essential functions are missing),
15
+ * then register the eligible tools and resources.
16
+ */
17
+ export async function buildServer(config, logger) {
18
+ const client = new MailStoreClient(config, logger);
19
+ const metadata = new MetadataService(client, config.metadataCacheTtlSeconds, logger);
20
+ const registry = new CapabilityRegistry(metadata, logger);
21
+ const resolver = new InstanceResolver(client, config.instanceCacheTtlSeconds, logger);
22
+ // Fail closed if metadata cannot be loaded or essential functions are absent.
23
+ await registry.initialize();
24
+ const server = new McpServer(SERVER_INFO, {
25
+ instructions: buildInstructions(config),
26
+ });
27
+ const ctx = { client, registry, resolver, metadata, config, logger };
28
+ const registration = registerTools(server, ctx);
29
+ registerResources(server, ctx);
30
+ return {
31
+ server,
32
+ ctx,
33
+ registration,
34
+ close: async () => {
35
+ await client.close();
36
+ },
37
+ };
38
+ }
39
+ function buildInstructions(config) {
40
+ return `
41
+ MailStore Service Provider Edition (SPE) MCP server — a curated, safety-gated administrator interface over the MailStore SPE Management API.
42
+
43
+ ## Access mode
44
+ - Current mode: ${config.accessMode}. Destructive tools ${config.allowDestructive ? 'are' : 'are NOT'} enabled. Raw API ${config.enableRawApi ? 'is' : 'is NOT'} enabled.
45
+ - read-only exposes only retrieval/reporting tools; operator adds run/verify/test/dry-run actions; administrator adds user and retention changes.
46
+ - Tools that are not permitted in the current mode are not registered at all.
47
+
48
+ ## Instances
49
+ - Almost every tool takes an "instance" selector: an exact instanceID, alias, or display name. It is resolved to exactly one instance; ambiguous names are rejected (AMBIGUOUS_INSTANCE) — never guess, list instances and pick the exact id.
50
+ - Use mailstore_list_instances or the mailstore://instances resource to discover instances.
51
+
52
+ ## Confirmations
53
+ - Operational, mutating and destructive tools require an exact confirmation string generated from the resolved instance and target, e.g. "STOP <instanceID>" or "DELETE USER <userName> FROM <instanceID>". Generic words like "yes" are rejected. If you omit or mismatch it, the tool returns CONFIRMATION_REQUIRED / CONFIRMATION_MISMATCH with the exact string required.
54
+
55
+ ## Output
56
+ - Tools return a concise summary plus structured data, with truncation info when list results are capped. Secrets are always redacted.
57
+
58
+ ## Long-running operations
59
+ - Verify, run-profile, run-job and directory sync may take time; the server waits for completion and returns the final result.
60
+ `.trim();
61
+ }
62
+ //# sourceMappingURL=server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAUtE,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,mCAAmC;IACzC,OAAO,EAAE,OAAO;CACR,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAiB,EAAE,MAAc;IACjE,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;IACrF,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;IAEtF,8EAA8E;IAC9E,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;IAE5B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,WAAW,EAAE;QACxC,YAAY,EAAE,iBAAiB,CAAC,MAAM,CAAC;KACxC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAElF,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChD,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE/B,OAAO;QACL,MAAM;QACN,GAAG;QACH,YAAY;QACZ,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAiB;IAC1C,OAAO;;;;kBAIS,MAAM,CAAC,UAAU,uBAAuB,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,qBAAqB,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ;;;;;;;;;;;;;;;;CAgB9J,CAAC,IAAI,EAAE,CAAC;AACT,CAAC"}
@@ -0,0 +1,6 @@
1
+ import { type ToolModule } from './tool.js';
2
+ /** Deterministic JSON serialisation with recursively sorted object keys. */
3
+ export declare function canonicalJson(value: unknown): string;
4
+ /** SHA-256 of the canonical JSON form of a value (hex). */
5
+ export declare function canonicalHash(value: unknown): string;
6
+ export declare const complianceTools: ToolModule[];
@@ -0,0 +1,96 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { z } from 'zod';
3
+ import { defineTool, instanceField, confirmationField, resolveInstance } from './tool.js';
4
+ import { buildResult } from '../output/tool-result.js';
5
+ import { assertConfirmation, confirmations } from '../policy/confirmations.js';
6
+ import { Errors } from '../mailstore/errors.js';
7
+ /** Deterministic JSON serialisation with recursively sorted object keys. */
8
+ export function canonicalJson(value) {
9
+ return JSON.stringify(sortKeys(value));
10
+ }
11
+ function sortKeys(value) {
12
+ if (Array.isArray(value))
13
+ return value.map(sortKeys);
14
+ if (value && typeof value === 'object') {
15
+ const out = {};
16
+ for (const key of Object.keys(value).sort()) {
17
+ out[key] = sortKeys(value[key]);
18
+ }
19
+ return out;
20
+ }
21
+ return value;
22
+ }
23
+ /** SHA-256 of the canonical JSON form of a value (hex). */
24
+ export function canonicalHash(value) {
25
+ return createHash('sha256').update(canonicalJson(value)).digest('hex');
26
+ }
27
+ export const complianceTools = [
28
+ defineTool({
29
+ name: 'mailstore_get_compliance',
30
+ description: 'Get the compliance configuration and retention policies for an instance (GetComplianceConfiguration, GetRetentionPolicies). Read-only. Also returns a canonical hash of the retention policies to use as expectedCurrentHash when changing them.',
31
+ policy: { minimumMode: 'read-only', risk: 'read', requiresConfirmation: false, permitsBulkTargets: false },
32
+ requiredFunctions: ['GetComplianceConfiguration', 'GetRetentionPolicies'],
33
+ inputShape: {
34
+ instance: instanceField,
35
+ },
36
+ handler: async (ctx, input) => {
37
+ const inst = await resolveInstance(ctx, input.instance);
38
+ const compliance = await ctx.client.invokeAndWait('GetComplianceConfiguration', { instanceID: inst.instanceID }, { retrySafe: true });
39
+ const retention = await ctx.client.invokeAndWait('GetRetentionPolicies', { instanceID: inst.instanceID }, { retrySafe: true });
40
+ return buildResult({
41
+ summary: `Compliance and retention configuration for ${inst.instanceID}`,
42
+ data: {
43
+ instanceID: inst.instanceID,
44
+ compliance,
45
+ retentionPolicies: retention,
46
+ retentionPoliciesHash: canonicalHash(retention),
47
+ },
48
+ });
49
+ },
50
+ }),
51
+ defineTool({
52
+ name: 'mailstore_set_retention_policies',
53
+ description: 'Replace the retention policies for an instance (SetRetentionPolicies) under an optimistic-concurrency guard. You must pass expectedCurrentHash (from mailstore_get_compliance); if the live policies changed, the call is refused. Destructive-gated administrator action requiring MCP_ALLOW_DESTRUCTIVE=true. Requires the exact confirmation string "CHANGE RETENTION POLICIES IN <instanceID>".',
54
+ policy: {
55
+ minimumMode: 'administrator',
56
+ risk: 'destructive',
57
+ requiresConfirmation: true,
58
+ requiresDestructiveFlag: true,
59
+ permitsBulkTargets: false,
60
+ },
61
+ requiredFunctions: ['SetRetentionPolicies', 'GetRetentionPolicies'],
62
+ inputShape: {
63
+ instance: instanceField,
64
+ config: z.record(z.string(), z.unknown()).describe('The new retention configuration to apply (e.g. { policies: [...] }).'),
65
+ expectedCurrentHash: z.string().min(1).describe('Canonical hash of the current retention policies (from mailstore_get_compliance).'),
66
+ confirmation: confirmationField,
67
+ },
68
+ handler: async (ctx, input) => {
69
+ const inst = await resolveInstance(ctx, input.instance);
70
+ // 1. Retrieve current, 2. hash, 3. compare.
71
+ const current = await ctx.client.invokeAndWait('GetRetentionPolicies', { instanceID: inst.instanceID }, { retrySafe: true });
72
+ const currentHash = canonicalHash(current);
73
+ if (currentHash !== input.expectedCurrentHash) {
74
+ throw Errors.concurrentModification('Retention policies changed since they were read; refusing to overwrite. Re-read with mailstore_get_compliance and retry.', { instanceID: inst.instanceID, expectedCurrentHash: input.expectedCurrentHash, actualHash: currentHash });
75
+ }
76
+ // 4. Confirmation, 5. apply.
77
+ assertConfirmation(confirmations.changeRetention(inst.instanceID), input.confirmation);
78
+ // SetRetentionPolicies takes a single JSON `config` argument.
79
+ await ctx.client.invokeAndWait('SetRetentionPolicies', {
80
+ instanceID: inst.instanceID,
81
+ config: input.config,
82
+ });
83
+ // 6. Return the resulting configuration.
84
+ const resulting = await ctx.client.invokeAndWait('GetRetentionPolicies', { instanceID: inst.instanceID }, { retrySafe: true });
85
+ return buildResult({
86
+ summary: `Retention policies updated for ${inst.instanceID}`,
87
+ data: {
88
+ instanceID: inst.instanceID,
89
+ retentionPolicies: resulting,
90
+ retentionPoliciesHash: canonicalHash(resulting),
91
+ },
92
+ });
93
+ },
94
+ }),
95
+ ];
96
+ //# sourceMappingURL=compliance.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compliance.js","sourceRoot":"","sources":["../../src/tools/compliance.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import { type ToolModule } from './tool.js';
2
+ import { asRecord } from '../output/normalizers.js';
3
+ export declare const instanceTools: ToolModule[];
4
+ export { asRecord };
@@ -0,0 +1,197 @@
1
+ import { z } from 'zod';
2
+ import { defineTool, instanceField, confirmationField, searchField, limitField, resolveInstance } from './tool.js';
3
+ import { buildResult } from '../output/tool-result.js';
4
+ import { limitItems, searchFilter } from '../output/truncation.js';
5
+ import { asRecord } from '../output/normalizers.js';
6
+ import { assertConfirmation, confirmations } from '../policy/confirmations.js';
7
+ const STATE_FILTERS = {
8
+ all: '*',
9
+ running: '*.running',
10
+ stopped: '*.stopped',
11
+ safeMode: '*.safemode',
12
+ };
13
+ export const instanceTools = [
14
+ defineTool({
15
+ name: 'mailstore_list_instances',
16
+ description: 'List MailStore SPE instances with normalised fields (instanceID, alias, displayName, host, state). Read-only. Supports an optional state filter and client-side search. Never performs write actions.',
17
+ policy: { minimumMode: 'read-only', risk: 'read', requiresConfirmation: false, permitsBulkTargets: false },
18
+ requiredFunctions: ['GetInstances'],
19
+ inputShape: {
20
+ state: z.enum(['all', 'running', 'stopped', 'safeMode']).optional().describe('Filter by instance state (default all).'),
21
+ search: searchField,
22
+ limit: limitField,
23
+ },
24
+ handler: async (ctx, input) => {
25
+ const filter = STATE_FILTERS[input.state ?? 'all'] ?? '*';
26
+ // For the "all" case we reuse the resolver cache; otherwise query directly.
27
+ const instances = filter === '*'
28
+ ? await ctx.resolver.list('*')
29
+ : await ctx.resolver.list(filter, true);
30
+ const summaries = instances.map(({ raw: _raw, ...rest }) => rest);
31
+ const filtered = searchFilter(summaries, input.search, ['instanceID', 'alias', 'displayName']);
32
+ const { items, truncated, totalCount, returnedCount } = limitItems(filtered, {
33
+ ...(input.limit !== undefined ? { limit: input.limit } : {}),
34
+ maxItems: ctx.config.maxResultItems,
35
+ });
36
+ return buildResult({
37
+ summary: `${returnedCount} of ${totalCount} instance(s)`,
38
+ data: items,
39
+ truncated,
40
+ totalCount,
41
+ returnedCount,
42
+ });
43
+ },
44
+ }),
45
+ defineTool({
46
+ name: 'mailstore_get_instance',
47
+ description: 'Get configuration and optional expansions for one instance (GetInstanceConfiguration, plus optionally statistics, live statistics, and stores). Read-only. Store size calculation is slow and is off by default.',
48
+ policy: { minimumMode: 'read-only', risk: 'read', requiresConfirmation: false, permitsBulkTargets: false },
49
+ requiredFunctions: ['GetInstanceConfiguration'],
50
+ inputShape: {
51
+ instance: instanceField,
52
+ includeStatistics: z.boolean().optional().describe('Include GetInstanceStatistics (default false).'),
53
+ includeLiveStatistics: z.boolean().optional().describe('Include GetInstanceProcessLiveStatistics (default false).'),
54
+ includeStores: z.boolean().optional().describe('Include GetStores (default false).'),
55
+ includeStoreSizes: z.boolean().optional().describe('Compute store sizes when including stores. Slow; default false.'),
56
+ },
57
+ handler: async (ctx, input) => {
58
+ const inst = await resolveInstance(ctx, input.instance);
59
+ const warnings = [];
60
+ const data = {
61
+ instanceID: inst.instanceID,
62
+ configuration: await ctx.client.invokeAndWait('GetInstanceConfiguration', { instanceID: inst.instanceID }, { retrySafe: true }),
63
+ };
64
+ if (input.includeStatistics) {
65
+ if (ctx.registry.has('GetInstanceStatistics')) {
66
+ data['statistics'] = await ctx.client.invokeAndWait('GetInstanceStatistics', { instanceID: inst.instanceID }, { retrySafe: true });
67
+ }
68
+ else
69
+ warnings.push('GetInstanceStatistics unavailable');
70
+ }
71
+ if (input.includeLiveStatistics) {
72
+ if (ctx.registry.has('GetInstanceProcessLiveStatistics')) {
73
+ data['liveStatistics'] = await ctx.client.invokeAndWait('GetInstanceProcessLiveStatistics', { instanceID: inst.instanceID }, { retrySafe: true });
74
+ }
75
+ else
76
+ warnings.push('GetInstanceProcessLiveStatistics unavailable');
77
+ }
78
+ if (input.includeStores) {
79
+ if (ctx.registry.has('GetStores')) {
80
+ data['stores'] = await ctx.client.invokeAndWait('GetStores', { instanceID: inst.instanceID, includeSize: input.includeStoreSizes ?? false }, { retrySafe: true });
81
+ }
82
+ else
83
+ warnings.push('GetStores unavailable');
84
+ }
85
+ return buildResult({
86
+ summary: `Instance ${inst.instanceID}${inst.displayName ? ` (${inst.displayName})` : ''}`,
87
+ data,
88
+ ...(warnings.length > 0 ? { warnings } : {}),
89
+ });
90
+ },
91
+ }),
92
+ defineTool({
93
+ name: 'mailstore_get_instance_statistics',
94
+ description: 'Get archive statistics for one instance (GetInstanceStatistics), optionally with live process statistics and folder statistics. Read-only.',
95
+ policy: { minimumMode: 'read-only', risk: 'read', requiresConfirmation: false, permitsBulkTargets: false },
96
+ requiredFunctions: ['GetInstanceStatistics'],
97
+ inputShape: {
98
+ instance: instanceField,
99
+ includeLive: z.boolean().optional().describe('Include GetInstanceProcessLiveStatistics (default false).'),
100
+ includeFolderStatistics: z.boolean().optional().describe('Include GetFolderStatistics (default false).'),
101
+ },
102
+ handler: async (ctx, input) => {
103
+ const inst = await resolveInstance(ctx, input.instance);
104
+ const warnings = [];
105
+ const data = {
106
+ instanceID: inst.instanceID,
107
+ statistics: await ctx.client.invokeAndWait('GetInstanceStatistics', { instanceID: inst.instanceID }, { retrySafe: true }),
108
+ };
109
+ if (input.includeLive) {
110
+ if (ctx.registry.has('GetInstanceProcessLiveStatistics')) {
111
+ data['liveStatistics'] = await ctx.client.invokeAndWait('GetInstanceProcessLiveStatistics', { instanceID: inst.instanceID }, { retrySafe: true });
112
+ }
113
+ else
114
+ warnings.push('GetInstanceProcessLiveStatistics unavailable');
115
+ }
116
+ if (input.includeFolderStatistics) {
117
+ if (ctx.registry.has('GetFolderStatistics')) {
118
+ data['folderStatistics'] = await ctx.client.invokeAndWait('GetFolderStatistics', { instanceID: inst.instanceID }, { retrySafe: true });
119
+ }
120
+ else
121
+ warnings.push('GetFolderStatistics unavailable');
122
+ }
123
+ return buildResult({
124
+ summary: `Statistics for instance ${inst.instanceID}`,
125
+ data,
126
+ ...(warnings.length > 0 ? { warnings } : {}),
127
+ });
128
+ },
129
+ }),
130
+ defineTool({
131
+ name: 'mailstore_start_instance',
132
+ description: 'Start ONE MailStore instance (StartInstances restricted to the single resolved instanceID; never a wildcard). Operator action. Requires the exact confirmation string "START <instanceID>".',
133
+ policy: { minimumMode: 'operator', risk: 'operational', requiresConfirmation: true, permitsBulkTargets: false },
134
+ requiredFunctions: ['StartInstances'],
135
+ inputShape: {
136
+ instance: instanceField,
137
+ safeMode: z.boolean().optional().describe('Start in safe mode (default false).'),
138
+ confirmation: confirmationField,
139
+ },
140
+ handler: async (ctx, input) => {
141
+ const inst = await resolveInstance(ctx, input.instance);
142
+ assertConfirmation(confirmations.startInstance(inst.instanceID), input.confirmation);
143
+ await ctx.client.invokeAndWait('StartInstances', {
144
+ instanceFilter: inst.instanceID,
145
+ ...(input.safeMode !== undefined ? { safeMode: input.safeMode } : {}),
146
+ });
147
+ ctx.resolver.invalidate();
148
+ return buildResult({
149
+ summary: `Started instance ${inst.instanceID}${input.safeMode ? ' (safe mode)' : ''}`,
150
+ data: { instanceID: inst.instanceID, action: 'start', safeMode: input.safeMode ?? false },
151
+ });
152
+ },
153
+ }),
154
+ defineTool({
155
+ name: 'mailstore_stop_instance',
156
+ description: 'Stop ONE MailStore instance (StopInstances restricted to the single resolved instanceID; never a wildcard). Operator action. Requires the exact confirmation string "STOP <instanceID>".',
157
+ policy: { minimumMode: 'operator', risk: 'operational', requiresConfirmation: true, permitsBulkTargets: false },
158
+ requiredFunctions: ['StopInstances'],
159
+ inputShape: {
160
+ instance: instanceField,
161
+ confirmation: confirmationField,
162
+ },
163
+ handler: async (ctx, input) => {
164
+ const inst = await resolveInstance(ctx, input.instance);
165
+ assertConfirmation(confirmations.stopInstance(inst.instanceID), input.confirmation);
166
+ await ctx.client.invokeAndWait('StopInstances', { instanceFilter: inst.instanceID });
167
+ ctx.resolver.invalidate();
168
+ return buildResult({
169
+ summary: `Stopped instance ${inst.instanceID}`,
170
+ data: { instanceID: inst.instanceID, action: 'stop' },
171
+ });
172
+ },
173
+ }),
174
+ defineTool({
175
+ name: 'mailstore_restart_instance',
176
+ description: 'Restart ONE MailStore instance (RestartInstances restricted to the single resolved instanceID; never a wildcard). Operator action. Requires the exact confirmation string "RESTART <instanceID>".',
177
+ policy: { minimumMode: 'operator', risk: 'operational', requiresConfirmation: true, permitsBulkTargets: false },
178
+ requiredFunctions: ['RestartInstances'],
179
+ inputShape: {
180
+ instance: instanceField,
181
+ confirmation: confirmationField,
182
+ },
183
+ handler: async (ctx, input) => {
184
+ const inst = await resolveInstance(ctx, input.instance);
185
+ assertConfirmation(confirmations.restartInstance(inst.instanceID), input.confirmation);
186
+ await ctx.client.invokeAndWait('RestartInstances', { instanceFilter: inst.instanceID });
187
+ ctx.resolver.invalidate();
188
+ return buildResult({
189
+ summary: `Restarted instance ${inst.instanceID}`,
190
+ data: { instanceID: inst.instanceID, action: 'restart' },
191
+ });
192
+ },
193
+ }),
194
+ ];
195
+ // re-export for tests
196
+ export { asRecord };
197
+ //# sourceMappingURL=instances.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"instances.js","sourceRoot":"","sources":["../../src/tools/instances.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ import { type ToolModule } from './tool.js';
2
+ export declare const jobTools: ToolModule[];
@@ -0,0 +1,125 @@
1
+ import { z } from 'zod';
2
+ import { defineTool, instanceField, confirmationField, searchField, limitField, resolveInstance } from './tool.js';
3
+ import { buildResult } from '../output/tool-result.js';
4
+ import { limitItems, searchFilter } from '../output/truncation.js';
5
+ import { asArray, asRecord, num, str } from '../output/normalizers.js';
6
+ import { assertConfirmation, confirmations } from '../policy/confirmations.js';
7
+ import { Errors } from '../mailstore/errors.js';
8
+ async function findJob(ctx, instanceID, jobId) {
9
+ const raw = await ctx.client.invokeAndWait('GetJobs', { instanceID }, { retrySafe: true });
10
+ const match = asArray(raw)
11
+ .map((j) => asRecord(j))
12
+ .find((j) => num(j['id']) === jobId || num(j['jobId']) === jobId);
13
+ if (!match)
14
+ throw Errors.objectNotFound(`Job ${jobId} not found in ${instanceID}`, { instanceID, jobId });
15
+ return match;
16
+ }
17
+ export const jobTools = [
18
+ defineTool({
19
+ name: 'mailstore_list_jobs',
20
+ description: 'List scheduled jobs in an instance (GetJobs). Read-only.',
21
+ policy: { minimumMode: 'read-only', risk: 'read', requiresConfirmation: false, permitsBulkTargets: false },
22
+ requiredFunctions: ['GetJobs'],
23
+ inputShape: {
24
+ instance: instanceField,
25
+ search: searchField,
26
+ limit: limitField,
27
+ },
28
+ handler: async (ctx, input) => {
29
+ const inst = await resolveInstance(ctx, input.instance);
30
+ const raw = await ctx.client.invokeAndWait('GetJobs', { instanceID: inst.instanceID }, { retrySafe: true });
31
+ const jobs = asArray(raw).map((j) => asRecord(j));
32
+ const filtered = searchFilter(jobs, input.search, ['name', 'action']);
33
+ const { items, truncated, totalCount, returnedCount } = limitItems(filtered, {
34
+ ...(input.limit !== undefined ? { limit: input.limit } : {}),
35
+ maxItems: ctx.config.maxResultItems,
36
+ });
37
+ return buildResult({
38
+ summary: `${returnedCount} of ${totalCount} job(s) in ${inst.instanceID}`,
39
+ data: items,
40
+ truncated,
41
+ totalCount,
42
+ returnedCount,
43
+ });
44
+ },
45
+ }),
46
+ defineTool({
47
+ name: 'mailstore_run_job',
48
+ description: 'Run a scheduled job immediately (RunJobAsync). Operational action. Requires the exact confirmation string "RUN JOB <jobId> IN <instanceID>".',
49
+ policy: { minimumMode: 'operator', risk: 'operational', requiresConfirmation: true, permitsBulkTargets: false },
50
+ requiredFunctions: ['RunJobAsync', 'GetJobs'],
51
+ inputShape: {
52
+ instance: instanceField,
53
+ jobId: z.number().int().describe('The job id to run.'),
54
+ confirmation: confirmationField,
55
+ },
56
+ handler: async (ctx, input) => {
57
+ const inst = await resolveInstance(ctx, input.instance);
58
+ const job = await findJob(ctx, inst.instanceID, input.jobId);
59
+ assertConfirmation(confirmations.runJob(input.jobId, inst.instanceID), input.confirmation);
60
+ const result = await ctx.client.invokeAndWait('RunJobAsync', { instanceID: inst.instanceID, id: input.jobId });
61
+ return buildResult({
62
+ summary: `Ran job ${input.jobId} (${str(job['name']) ?? 'unnamed'}) in ${inst.instanceID}`,
63
+ data: { instanceID: inst.instanceID, jobId: input.jobId, jobName: str(job['name']), result },
64
+ });
65
+ },
66
+ }),
67
+ defineTool({
68
+ name: 'mailstore_cancel_job',
69
+ description: 'Cancel a running job (CancelJobAsync). Operational action. Requires the exact confirmation string "CANCEL JOB <jobId> IN <instanceID>".',
70
+ policy: { minimumMode: 'operator', risk: 'operational', requiresConfirmation: true, permitsBulkTargets: false },
71
+ requiredFunctions: ['CancelJobAsync'],
72
+ inputShape: {
73
+ instance: instanceField,
74
+ jobId: z.number().int().describe('The job id to cancel.'),
75
+ confirmation: confirmationField,
76
+ },
77
+ handler: async (ctx, input) => {
78
+ const inst = await resolveInstance(ctx, input.instance);
79
+ assertConfirmation(confirmations.cancelJob(input.jobId, inst.instanceID), input.confirmation);
80
+ const result = await ctx.client.invokeAndWait('CancelJobAsync', { instanceID: inst.instanceID, id: input.jobId });
81
+ return buildResult({
82
+ summary: `Requested cancel of job ${input.jobId} in ${inst.instanceID}`,
83
+ data: { instanceID: inst.instanceID, jobId: input.jobId, result },
84
+ });
85
+ },
86
+ }),
87
+ defineTool({
88
+ name: 'mailstore_get_job_results',
89
+ description: 'Get scheduled-job execution results over a time range (GetJobResults). Read-only. Dates are ISO 8601; timeZoneId defaults to $Local.',
90
+ policy: { minimumMode: 'read-only', risk: 'read', requiresConfirmation: false, permitsBulkTargets: false },
91
+ requiredFunctions: ['GetJobResults'],
92
+ inputShape: {
93
+ instance: instanceField,
94
+ from: z.string().describe('Start of the range (ISO 8601).'),
95
+ to: z.string().describe('End of the range (ISO 8601).'),
96
+ timeZoneId: z.string().optional().describe('MailStore time zone id (default $Local).'),
97
+ jobId: z.number().int().optional().describe('Restrict to a single job id.'),
98
+ limit: limitField,
99
+ },
100
+ handler: async (ctx, input) => {
101
+ const inst = await resolveInstance(ctx, input.instance);
102
+ const tz = input.timeZoneId ?? '$Local';
103
+ const raw = await ctx.client.invokeAndWait('GetJobResults', {
104
+ instanceID: inst.instanceID,
105
+ fromIncluding: input.from,
106
+ toExcluding: input.to,
107
+ timeZoneId: tz,
108
+ ...(input.jobId !== undefined ? { jobId: input.jobId } : {}),
109
+ }, { retrySafe: true });
110
+ const results = asArray(raw).map((r) => asRecord(r));
111
+ const { items, truncated, totalCount, returnedCount } = limitItems(results, {
112
+ ...(input.limit !== undefined ? { limit: input.limit } : {}),
113
+ maxItems: ctx.config.maxResultItems,
114
+ });
115
+ return buildResult({
116
+ summary: `${returnedCount} of ${totalCount} job result(s) in ${inst.instanceID}`,
117
+ data: { instanceID: inst.instanceID, timeZoneId: tz, results: items },
118
+ truncated,
119
+ totalCount,
120
+ returnedCount,
121
+ });
122
+ },
123
+ }),
124
+ ];
125
+ //# sourceMappingURL=jobs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../src/tools/jobs.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import { type ToolModule } from './tool.js';
2
+ /** Administrator maintenance tools (§9.3). */
3
+ export declare const maintenanceTools: ToolModule[];
@@ -0,0 +1,22 @@
1
+ import { defineTool } from './tool.js';
2
+ import { buildResult } from '../output/tool-result.js';
3
+ /** Administrator maintenance tools (§9.3). */
4
+ export const maintenanceTools = [
5
+ defineTool({
6
+ name: 'mailstore_refresh_capabilities',
7
+ description: 'Re-fetch MailStore API metadata and rebuild the capability registry, and invalidate the instance cache. Administrator-only. Use after upgrading MailStore or changing available functions.',
8
+ policy: { minimumMode: 'administrator', risk: 'read', requiresConfirmation: false, permitsBulkTargets: false },
9
+ requiredFunctions: [],
10
+ inputShape: {},
11
+ handler: async (ctx) => {
12
+ ctx.metadata.invalidate();
13
+ await ctx.registry.reload();
14
+ ctx.resolver.invalidate();
15
+ return buildResult({
16
+ summary: `Reloaded capabilities: ${ctx.registry.functionCount} functions available`,
17
+ data: { functionCount: ctx.registry.functionCount },
18
+ });
19
+ },
20
+ }),
21
+ ];
22
+ //# sourceMappingURL=maintenance.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"maintenance.js","sourceRoot":"","sources":["../../src/tools/maintenance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAmB,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,gBAAgB,GAAiB;IAC5C,UAAU,CAAC;QACT,IAAI,EAAE,gCAAgC;QACtC,WAAW,EACT,4LAA4L;QAC9L,MAAM,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE;QAC9G,iBAAiB,EAAE,EAAE;QACrB,UAAU,EAAE,EAAE;QACd,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACrB,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC1B,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC5B,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC1B,OAAO,WAAW,CAAC;gBACjB,OAAO,EAAE,0BAA0B,GAAG,CAAC,QAAQ,CAAC,aAAa,sBAAsB;gBACnF,IAAI,EAAE,EAAE,aAAa,EAAE,GAAG,CAAC,QAAQ,CAAC,aAAa,EAAE;aACpD,CAAC,CAAC;QACL,CAAC;KACF,CAAC;CACH,CAAC"}
@@ -0,0 +1,4 @@
1
+ import { type ToolModule } from './tool.js';
2
+ export declare const platformTools: ToolModule[];
3
+ export declare function summariseInstances(result: unknown): Array<Record<string, unknown>>;
4
+ export declare function stateOf(rec: Record<string, unknown>): string;