run-dmcp 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 (167) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +79 -0
  3. package/dist/__tests__/engineVocabulary.test.d.ts +1 -0
  4. package/dist/__tests__/engineVocabulary.test.js +147 -0
  5. package/dist/db/__tests__/connection.test.d.ts +1 -0
  6. package/dist/db/__tests__/connection.test.js +72 -0
  7. package/dist/db/__tests__/testDb.d.ts +33 -0
  8. package/dist/db/__tests__/testDb.js +41 -0
  9. package/dist/db/connection.d.ts +22 -0
  10. package/dist/db/connection.js +107 -0
  11. package/dist/db/schema.d.ts +1 -0
  12. package/dist/db/schema.js +725 -0
  13. package/dist/events/emitter.d.ts +22 -0
  14. package/dist/events/emitter.js +71 -0
  15. package/dist/http/server.d.ts +3 -0
  16. package/dist/http/server.js +649 -0
  17. package/dist/index.d.ts +2 -0
  18. package/dist/index.js +92 -0
  19. package/dist/register/abilities.d.ts +2 -0
  20. package/dist/register/abilities.js +165 -0
  21. package/dist/register/audio.d.ts +2 -0
  22. package/dist/register/audio.js +326 -0
  23. package/dist/register/batch.d.ts +2 -0
  24. package/dist/register/batch.js +343 -0
  25. package/dist/register/character.d.ts +2 -0
  26. package/dist/register/character.js +324 -0
  27. package/dist/register/combat.d.ts +2 -0
  28. package/dist/register/combat.js +207 -0
  29. package/dist/register/core.d.ts +2 -0
  30. package/dist/register/core.js +1040 -0
  31. package/dist/register/display.d.ts +2 -0
  32. package/dist/register/display.js +263 -0
  33. package/dist/register/factions.d.ts +2 -0
  34. package/dist/register/factions.js +186 -0
  35. package/dist/register/images.d.ts +2 -0
  36. package/dist/register/images.js +400 -0
  37. package/dist/register/inventory.d.ts +2 -0
  38. package/dist/register/inventory.js +115 -0
  39. package/dist/register/mcp-prompts.d.ts +2 -0
  40. package/dist/register/mcp-prompts.js +684 -0
  41. package/dist/register/mcp-resources.d.ts +2 -0
  42. package/dist/register/mcp-resources.js +335 -0
  43. package/dist/register/narrative.d.ts +2 -0
  44. package/dist/register/narrative.js +242 -0
  45. package/dist/register/notes.d.ts +2 -0
  46. package/dist/register/notes.js +170 -0
  47. package/dist/register/pause.d.ts +2 -0
  48. package/dist/register/pause.js +580 -0
  49. package/dist/register/quests.d.ts +2 -0
  50. package/dist/register/quests.js +118 -0
  51. package/dist/register/relationships.d.ts +2 -0
  52. package/dist/register/relationships.js +147 -0
  53. package/dist/register/resources.d.ts +2 -0
  54. package/dist/register/resources.js +277 -0
  55. package/dist/register/secrets.d.ts +2 -0
  56. package/dist/register/secrets.js +192 -0
  57. package/dist/register/status.d.ts +2 -0
  58. package/dist/register/status.js +130 -0
  59. package/dist/register/tables.d.ts +2 -0
  60. package/dist/register/tables.js +146 -0
  61. package/dist/register/tags.d.ts +2 -0
  62. package/dist/register/tags.js +114 -0
  63. package/dist/register/time.d.ts +2 -0
  64. package/dist/register/time.js +281 -0
  65. package/dist/register/world.d.ts +2 -0
  66. package/dist/register/world.js +127 -0
  67. package/dist/schemas/index.d.ts +921 -0
  68. package/dist/schemas/index.js +121 -0
  69. package/dist/test-setup.d.ts +1 -0
  70. package/dist/test-setup.js +13 -0
  71. package/dist/tools/__tests__/audio.test.d.ts +1 -0
  72. package/dist/tools/__tests__/audio.test.js +59 -0
  73. package/dist/tools/__tests__/conserved.test.d.ts +1 -0
  74. package/dist/tools/__tests__/conserved.test.js +488 -0
  75. package/dist/tools/__tests__/constraint.test.d.ts +1 -0
  76. package/dist/tools/__tests__/constraint.test.js +212 -0
  77. package/dist/tools/__tests__/expiry-consequences.test.d.ts +1 -0
  78. package/dist/tools/__tests__/expiry-consequences.test.js +110 -0
  79. package/dist/tools/__tests__/images.test.d.ts +1 -0
  80. package/dist/tools/__tests__/images.test.js +59 -0
  81. package/dist/tools/__tests__/relationship.test.d.ts +1 -0
  82. package/dist/tools/__tests__/relationship.test.js +132 -0
  83. package/dist/tools/__tests__/resource-constraints.test.d.ts +1 -0
  84. package/dist/tools/__tests__/resource-constraints.test.js +131 -0
  85. package/dist/tools/__tests__/resource.test.d.ts +1 -0
  86. package/dist/tools/__tests__/resource.test.js +190 -0
  87. package/dist/tools/__tests__/time.test.d.ts +1 -0
  88. package/dist/tools/__tests__/time.test.js +404 -0
  89. package/dist/tools/__tests__/timers.test.d.ts +1 -0
  90. package/dist/tools/__tests__/timers.test.js +426 -0
  91. package/dist/tools/__tests__/world.test.d.ts +1 -0
  92. package/dist/tools/__tests__/world.test.js +70 -0
  93. package/dist/tools/ability.d.ts +48 -0
  94. package/dist/tools/ability.js +238 -0
  95. package/dist/tools/audio.d.ts +24 -0
  96. package/dist/tools/audio.js +365 -0
  97. package/dist/tools/character.d.ts +70 -0
  98. package/dist/tools/character.js +309 -0
  99. package/dist/tools/combat.d.ts +13 -0
  100. package/dist/tools/combat.js +195 -0
  101. package/dist/tools/constraint.d.ts +132 -0
  102. package/dist/tools/constraint.js +269 -0
  103. package/dist/tools/dice.d.ts +23 -0
  104. package/dist/tools/dice.js +111 -0
  105. package/dist/tools/display.d.ts +120 -0
  106. package/dist/tools/display.js +528 -0
  107. package/dist/tools/faction.d.ts +61 -0
  108. package/dist/tools/faction.js +269 -0
  109. package/dist/tools/game.d.ts +96 -0
  110. package/dist/tools/game.js +526 -0
  111. package/dist/tools/image-prompt.d.ts +49 -0
  112. package/dist/tools/image-prompt.js +479 -0
  113. package/dist/tools/images.d.ts +47 -0
  114. package/dist/tools/images.js +449 -0
  115. package/dist/tools/inventory.d.ts +20 -0
  116. package/dist/tools/inventory.js +145 -0
  117. package/dist/tools/narrative.d.ts +58 -0
  118. package/dist/tools/narrative.js +237 -0
  119. package/dist/tools/notes.d.ts +41 -0
  120. package/dist/tools/notes.js +220 -0
  121. package/dist/tools/pause.d.ts +110 -0
  122. package/dist/tools/pause.js +1254 -0
  123. package/dist/tools/quest.d.ts +34 -0
  124. package/dist/tools/quest.js +164 -0
  125. package/dist/tools/relationship.d.ts +74 -0
  126. package/dist/tools/relationship.js +324 -0
  127. package/dist/tools/resource.d.ts +93 -0
  128. package/dist/tools/resource.js +374 -0
  129. package/dist/tools/rules.d.ts +4 -0
  130. package/dist/tools/rules.js +30 -0
  131. package/dist/tools/secrets.d.ts +49 -0
  132. package/dist/tools/secrets.js +195 -0
  133. package/dist/tools/status.d.ts +36 -0
  134. package/dist/tools/status.js +218 -0
  135. package/dist/tools/tables.d.ts +33 -0
  136. package/dist/tools/tables.js +209 -0
  137. package/dist/tools/tags.d.ts +52 -0
  138. package/dist/tools/tags.js +176 -0
  139. package/dist/tools/time.d.ts +33 -0
  140. package/dist/tools/time.js +276 -0
  141. package/dist/tools/timers.d.ts +41 -0
  142. package/dist/tools/timers.js +215 -0
  143. package/dist/tools/world.d.ts +78 -0
  144. package/dist/tools/world.js +331 -0
  145. package/dist/types/index.d.ts +969 -0
  146. package/dist/types/index.js +1 -0
  147. package/dist/utils/__tests__/json.test.d.ts +1 -0
  148. package/dist/utils/__tests__/json.test.js +55 -0
  149. package/dist/utils/__tests__/validation.test.d.ts +1 -0
  150. package/dist/utils/__tests__/validation.test.js +90 -0
  151. package/dist/utils/errors.d.ts +44 -0
  152. package/dist/utils/errors.js +121 -0
  153. package/dist/utils/json.d.ts +9 -0
  154. package/dist/utils/json.js +23 -0
  155. package/dist/utils/logger.d.ts +7 -0
  156. package/dist/utils/logger.js +50 -0
  157. package/dist/utils/output-schemas.d.ts +594 -0
  158. package/dist/utils/output-schemas.js +331 -0
  159. package/dist/utils/tool-annotations.d.ts +147 -0
  160. package/dist/utils/tool-annotations.js +98 -0
  161. package/dist/utils/validation.d.ts +34 -0
  162. package/dist/utils/validation.js +52 -0
  163. package/dist/utils/verbosity.d.ts +57 -0
  164. package/dist/utils/verbosity.js +67 -0
  165. package/dist/utils/webui.d.ts +20 -0
  166. package/dist/utils/webui.js +35 -0
  167. package/package.json +75 -0
@@ -0,0 +1,207 @@
1
+ import { z } from "zod";
2
+ import * as combatTools from "../tools/combat.js";
3
+ import * as diceTools from "../tools/dice.js";
4
+ import { LIMITS } from "../utils/validation.js";
5
+ import { ANNOTATIONS } from "../utils/tool-annotations.js";
6
+ export function registerCombatTools(server) {
7
+ // ============================================================================
8
+ // DICE & CHECK TOOLS
9
+ // ============================================================================
10
+ server.registerTool("roll", {
11
+ description: "Roll dice using standard notation",
12
+ inputSchema: {
13
+ expression: z.string().max(100).describe("Dice expression (e.g., '2d6+3', '1d20', '4d6-2')"),
14
+ },
15
+ annotations: ANNOTATIONS.READ_ONLY,
16
+ }, async ({ expression }) => {
17
+ try {
18
+ const result = diceTools.roll(expression);
19
+ return {
20
+ content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
21
+ };
22
+ }
23
+ catch (error) {
24
+ return {
25
+ content: [{ type: "text", text: error.message }],
26
+ isError: true,
27
+ };
28
+ }
29
+ });
30
+ server.registerTool("check", {
31
+ description: "Perform a skill or ability check",
32
+ inputSchema: {
33
+ gameId: z.string().max(100).describe("The game ID"),
34
+ characterId: z.string().max(100).describe("The character making the check"),
35
+ skill: z.string().max(100).optional().describe("Skill to use"),
36
+ attribute: z.string().max(100).optional().describe("Attribute to use"),
37
+ difficulty: z.number().describe("Difficulty threshold"),
38
+ bonusModifier: z.number().optional().describe("Additional modifier"),
39
+ },
40
+ annotations: ANNOTATIONS.READ_ONLY,
41
+ }, async (params) => {
42
+ try {
43
+ const result = diceTools.check(params);
44
+ return {
45
+ content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
46
+ };
47
+ }
48
+ catch (error) {
49
+ return {
50
+ content: [{ type: "text", text: error.message }],
51
+ isError: true,
52
+ };
53
+ }
54
+ });
55
+ server.registerTool("contest", {
56
+ description: "Opposed check between two characters",
57
+ inputSchema: {
58
+ gameId: z.string().max(100).describe("The game ID"),
59
+ attackerId: z.string().max(100).describe("First character ID"),
60
+ defenderId: z.string().max(100).describe("Second character ID"),
61
+ attackerSkill: z.string().max(100).optional().describe("Skill for first character"),
62
+ defenderSkill: z.string().max(100).optional().describe("Skill for second character"),
63
+ attackerAttribute: z.string().max(100).optional().describe("Attribute for first character"),
64
+ defenderAttribute: z.string().max(100).optional().describe("Attribute for second character"),
65
+ },
66
+ annotations: ANNOTATIONS.READ_ONLY,
67
+ }, async (params) => {
68
+ try {
69
+ const result = diceTools.contest(params);
70
+ return {
71
+ content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
72
+ };
73
+ }
74
+ catch (error) {
75
+ return {
76
+ content: [{ type: "text", text: error.message }],
77
+ isError: true,
78
+ };
79
+ }
80
+ });
81
+ // ============================================================================
82
+ // COMBAT TOOLS
83
+ // ============================================================================
84
+ server.registerTool("start_combat", {
85
+ description: "Initialize a combat encounter",
86
+ inputSchema: {
87
+ gameId: z.string().max(100).describe("The game ID"),
88
+ locationId: z.string().max(100).describe("Location where combat occurs"),
89
+ participantIds: z.array(z.string().max(100)).max(LIMITS.ARRAY_MAX).describe("Character IDs of all combatants"),
90
+ },
91
+ annotations: ANNOTATIONS.CREATE,
92
+ }, async (params) => {
93
+ const combat = combatTools.startCombat(params);
94
+ return {
95
+ content: [{ type: "text", text: JSON.stringify(combat, null, 2) }],
96
+ };
97
+ });
98
+ server.registerTool("get_combat", {
99
+ description: "Get current combat state",
100
+ inputSchema: {
101
+ combatId: z.string().max(100).describe("The combat ID"),
102
+ },
103
+ annotations: ANNOTATIONS.READ_ONLY,
104
+ }, async ({ combatId }) => {
105
+ const combat = combatTools.getCombat(combatId);
106
+ if (!combat) {
107
+ return {
108
+ content: [{ type: "text", text: "Combat not found" }],
109
+ isError: true,
110
+ };
111
+ }
112
+ return {
113
+ content: [{ type: "text", text: JSON.stringify(combat, null, 2) }],
114
+ };
115
+ });
116
+ server.registerTool("get_active_combat", {
117
+ description: "Get the active combat for a game",
118
+ inputSchema: {
119
+ gameId: z.string().max(100).describe("The game ID"),
120
+ },
121
+ annotations: ANNOTATIONS.READ_ONLY,
122
+ }, async ({ gameId }) => {
123
+ const combat = combatTools.getActiveCombat(gameId);
124
+ if (!combat) {
125
+ return {
126
+ content: [{ type: "text", text: "No active combat" }],
127
+ };
128
+ }
129
+ return {
130
+ content: [{ type: "text", text: JSON.stringify(combat, null, 2) }],
131
+ };
132
+ });
133
+ server.registerTool("next_turn", {
134
+ description: "Advance to the next combatant's turn",
135
+ inputSchema: {
136
+ combatId: z.string().max(100).describe("The combat ID"),
137
+ },
138
+ annotations: ANNOTATIONS.UPDATE,
139
+ }, async ({ combatId }) => {
140
+ const combat = combatTools.nextTurn(combatId);
141
+ if (!combat) {
142
+ return {
143
+ content: [{ type: "text", text: "Combat not found or ended" }],
144
+ isError: true,
145
+ };
146
+ }
147
+ return {
148
+ content: [{ type: "text", text: JSON.stringify(combat, null, 2) }],
149
+ };
150
+ });
151
+ server.registerTool("add_combat_log", {
152
+ description: "Add an entry to the combat log",
153
+ inputSchema: {
154
+ combatId: z.string().max(100).describe("The combat ID"),
155
+ entry: z.string().max(LIMITS.DESCRIPTION_MAX).describe("Log entry text"),
156
+ },
157
+ annotations: ANNOTATIONS.UPDATE,
158
+ }, async ({ combatId, entry }) => {
159
+ const combat = combatTools.addCombatLog(combatId, entry);
160
+ if (!combat) {
161
+ return {
162
+ content: [{ type: "text", text: "Combat not found" }],
163
+ isError: true,
164
+ };
165
+ }
166
+ return {
167
+ content: [{ type: "text", text: JSON.stringify(combat, null, 2) }],
168
+ };
169
+ });
170
+ server.registerTool("remove_combatant", {
171
+ description: "Remove a character from combat (defeated, fled, etc.)",
172
+ inputSchema: {
173
+ combatId: z.string().max(100).describe("The combat ID"),
174
+ characterId: z.string().max(100).describe("The character to remove"),
175
+ },
176
+ annotations: ANNOTATIONS.DESTRUCTIVE,
177
+ }, async ({ combatId, characterId }) => {
178
+ const combat = combatTools.removeParticipant(combatId, characterId);
179
+ if (!combat) {
180
+ return {
181
+ content: [{ type: "text", text: "Combat not found" }],
182
+ isError: true,
183
+ };
184
+ }
185
+ return {
186
+ content: [{ type: "text", text: JSON.stringify(combat, null, 2) }],
187
+ };
188
+ });
189
+ server.registerTool("end_combat", {
190
+ description: "End a combat encounter",
191
+ inputSchema: {
192
+ combatId: z.string().max(100).describe("The combat ID"),
193
+ },
194
+ annotations: ANNOTATIONS.UPDATE,
195
+ }, async ({ combatId }) => {
196
+ const combat = combatTools.endCombat(combatId);
197
+ if (!combat) {
198
+ return {
199
+ content: [{ type: "text", text: "Combat not found" }],
200
+ isError: true,
201
+ };
202
+ }
203
+ return {
204
+ content: [{ type: "text", text: JSON.stringify(combat, null, 2) }],
205
+ };
206
+ });
207
+ }
@@ -0,0 +1,2 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ export declare function registerCoreTools(server: McpServer): void;