@rolexjs/mcp-server 1.4.0-dev-20260305012717 → 1.4.0-dev-20260305032702

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 (3) hide show
  1. package/dist/index.js +94 -159
  2. package/dist/index.js.map +1 -1
  3. package/package.json +4 -4
package/dist/index.js CHANGED
@@ -4,13 +4,15 @@
4
4
  import { genesis } from "@rolexjs/genesis";
5
5
  import { localPlatform } from "@rolexjs/local-platform";
6
6
  import { FastMCP } from "fastmcp";
7
- import { createRoleX, detail, renderProjectResult } from "rolexjs";
7
+ import {
8
+ createRoleX,
9
+ detail,
10
+ renderProjectResult,
11
+ tools,
12
+ worldInstructions
13
+ } from "rolexjs";
8
14
  import { z } from "zod";
9
15
 
10
- // src/instructions.ts
11
- import { world } from "rolexjs";
12
- var instructions = Object.values(world).join("\n\n");
13
-
14
16
  // src/state.ts
15
17
  var McpState = class {
16
18
  role = null;
@@ -27,18 +29,39 @@ var rolex = await createRoleX(
27
29
  })
28
30
  );
29
31
  var state = new McpState();
30
- var server = new FastMCP({
31
- name: "rolex",
32
- version: "0.12.0",
33
- instructions
34
- });
35
- server.addTool({
36
- name: "activate",
37
- description: detail("activate"),
38
- parameters: z.object({
39
- roleId: z.string().describe("Role name to activate")
40
- }),
41
- execute: async ({ roleId }) => {
32
+ function paramToZod(param, required) {
33
+ let zodType;
34
+ switch (param.type) {
35
+ case "string":
36
+ case "gherkin":
37
+ zodType = z.string();
38
+ break;
39
+ case "string[]":
40
+ zodType = z.array(z.string());
41
+ break;
42
+ case "number":
43
+ zodType = z.number();
44
+ break;
45
+ case "record":
46
+ zodType = z.record(z.unknown());
47
+ break;
48
+ default:
49
+ zodType = z.unknown();
50
+ }
51
+ zodType = zodType.describe(param.description);
52
+ if (!required) zodType = zodType.optional();
53
+ return zodType;
54
+ }
55
+ function toZodSchema(def) {
56
+ const shape = {};
57
+ for (const [key, param] of Object.entries(def.params)) {
58
+ shape[key] = paramToZod(param, param.required);
59
+ }
60
+ const schema = z.object(shape);
61
+ return def.additionalProperties ? schema.catchall(z.unknown()) : schema;
62
+ }
63
+ var executors = {
64
+ async activate({ roleId }) {
42
65
  try {
43
66
  const role = await rolex.activate(roleId);
44
67
  state.role = role;
@@ -53,163 +76,56 @@ ${census}
53
76
  Try again with the correct id or alias.`
54
77
  );
55
78
  }
56
- }
57
- });
58
- server.addTool({
59
- name: "focus",
60
- description: detail("focus"),
61
- parameters: z.object({
62
- id: z.string().optional().describe("Goal id to switch to. Omit to view current.")
63
- }),
64
- execute: async ({ id }) => {
79
+ },
80
+ async focus({ id }) {
65
81
  return await state.requireRole().focus(id);
66
- }
67
- });
68
- server.addTool({
69
- name: "want",
70
- description: detail("want"),
71
- parameters: z.object({
72
- id: z.string().describe("Goal id (used for focus/reference)"),
73
- goal: z.string().describe("Gherkin Feature source describing the goal")
74
- }),
75
- execute: async ({ id, goal }) => {
82
+ },
83
+ async want({ id, goal }) {
76
84
  return await state.requireRole().want(goal, id);
77
- }
78
- });
79
- server.addTool({
80
- name: "plan",
81
- description: detail("plan"),
82
- parameters: z.object({
83
- id: z.string().describe("Plan id \u2014 keywords from the plan content joined by hyphens"),
84
- plan: z.string().describe("Gherkin Feature source describing the plan"),
85
- after: z.string().optional().describe("Plan id this plan follows (sequential/phase relationship)"),
86
- fallback: z.string().optional().describe("Plan id this plan is a backup for (alternative/strategy relationship)")
87
- }),
88
- execute: async ({ id, plan, after, fallback }) => {
89
- return await state.requireRole().plan(plan, id, after, fallback);
90
- }
91
- });
92
- server.addTool({
93
- name: "todo",
94
- description: detail("todo"),
95
- parameters: z.object({
96
- id: z.string().describe("Task id (used for finish/reference)"),
97
- task: z.string().describe("Gherkin Feature source describing the task")
98
- }),
99
- execute: async ({ id, task }) => {
85
+ },
86
+ async plan({ id, plan, after, fallback }) {
87
+ return await state.requireRole().plan(
88
+ plan,
89
+ id,
90
+ after,
91
+ fallback
92
+ );
93
+ },
94
+ async todo({ id, task }) {
100
95
  return await state.requireRole().todo(task, id);
101
- }
102
- });
103
- server.addTool({
104
- name: "finish",
105
- description: detail("finish"),
106
- parameters: z.object({
107
- id: z.string().describe("Task id to finish"),
108
- encounter: z.string().optional().describe("Optional Gherkin Feature describing what happened")
109
- }),
110
- execute: async ({ id, encounter }) => {
96
+ },
97
+ async finish({ id, encounter }) {
111
98
  return await state.requireRole().finish(id, encounter);
112
- }
113
- });
114
- server.addTool({
115
- name: "complete",
116
- description: detail("complete"),
117
- parameters: z.object({
118
- id: z.string().optional().describe("Plan id to complete (defaults to focused plan)"),
119
- encounter: z.string().optional().describe("Optional Gherkin Feature describing what happened")
120
- }),
121
- execute: async ({ id, encounter }) => {
99
+ },
100
+ async complete({ id, encounter }) {
122
101
  return await state.requireRole().complete(id, encounter);
123
- }
124
- });
125
- server.addTool({
126
- name: "abandon",
127
- description: detail("abandon"),
128
- parameters: z.object({
129
- id: z.string().optional().describe("Plan id to abandon (defaults to focused plan)"),
130
- encounter: z.string().optional().describe("Optional Gherkin Feature describing what happened")
131
- }),
132
- execute: async ({ id, encounter }) => {
102
+ },
103
+ async abandon({ id, encounter }) {
133
104
  return await state.requireRole().abandon(id, encounter);
134
- }
135
- });
136
- server.addTool({
137
- name: "reflect",
138
- description: detail("reflect"),
139
- parameters: z.object({
140
- ids: z.array(z.string()).describe("Encounter ids to reflect on (selective consumption)"),
141
- id: z.string().describe("Experience id \u2014 keywords from the experience content joined by hyphens"),
142
- experience: z.string().optional().describe("Gherkin Feature source for the experience")
143
- }),
144
- execute: async ({ ids, id, experience }) => {
105
+ },
106
+ async reflect({ ids, id, experience }) {
145
107
  return await state.requireRole().reflect(ids, experience, id);
146
- }
147
- });
148
- server.addTool({
149
- name: "realize",
150
- description: detail("realize"),
151
- parameters: z.object({
152
- ids: z.array(z.string()).describe("Experience ids to distill into a principle"),
153
- id: z.string().describe("Principle id \u2014 keywords from the principle content joined by hyphens"),
154
- principle: z.string().optional().describe("Gherkin Feature source for the principle")
155
- }),
156
- execute: async ({ ids, id, principle }) => {
108
+ },
109
+ async realize({ ids, id, principle }) {
157
110
  return await state.requireRole().realize(ids, principle, id);
158
- }
159
- });
160
- server.addTool({
161
- name: "master",
162
- description: detail("master"),
163
- parameters: z.object({
164
- ids: z.array(z.string()).optional().describe("Experience ids to distill into a procedure"),
165
- id: z.string().describe("Procedure id \u2014 keywords from the procedure content joined by hyphens"),
166
- procedure: z.string().describe("Gherkin Feature source for the procedure")
167
- }),
168
- execute: async ({ ids, id, procedure }) => {
111
+ },
112
+ async master({ ids, id, procedure }) {
169
113
  return await state.requireRole().master(procedure, id, ids);
170
- }
171
- });
172
- server.addTool({
173
- name: "forget",
174
- description: detail("forget"),
175
- parameters: z.object({
176
- id: z.string().describe("Id of the node to remove (principle, procedure, experience, encounter, etc.)")
177
- }),
178
- execute: async ({ id }) => {
114
+ },
115
+ async forget({ id }) {
179
116
  return await state.requireRole().forget(id);
180
- }
181
- });
182
- server.addTool({
183
- name: "skill",
184
- description: detail("skill"),
185
- parameters: z.object({
186
- locator: z.string().describe("ResourceX locator for the skill (e.g. deepractice/role-management)")
187
- }),
188
- execute: async ({ locator }) => {
117
+ },
118
+ async skill({ locator }) {
189
119
  return await state.requireRole().skill(locator);
190
- }
191
- });
192
- server.addTool({
193
- name: "use",
194
- description: detail("use"),
195
- parameters: z.object({
196
- command: z.string().describe("!namespace.method for RoleX commands, or a ResourceX locator for resources")
197
- }).catchall(z.unknown()),
198
- execute: async (params) => {
120
+ },
121
+ async use(params) {
199
122
  const { command, ...args } = params;
200
123
  const result = await state.requireRole().use(command, Object.keys(args).length > 0 ? args : void 0);
201
124
  if (result == null) return `${command} done.`;
202
125
  if (typeof result === "string") return result;
203
126
  return JSON.stringify(result, null, 2);
204
- }
205
- });
206
- server.addTool({
207
- name: "direct",
208
- description: detail("direct"),
209
- parameters: z.object({
210
- command: z.string().describe("!namespace.method for RoleX commands, or a ResourceX locator for resources")
211
- }).catchall(z.unknown()),
212
- execute: async (params) => {
127
+ },
128
+ async direct(params) {
213
129
  const { command, ...args } = params;
214
130
  const result = await rolex.direct(
215
131
  command,
@@ -224,7 +140,26 @@ server.addTool({
224
140
  }
225
141
  return JSON.stringify(result, null, 2);
226
142
  }
227
- });
143
+ };
144
+ var server = new FastMCP({
145
+ name: "rolex",
146
+ version: "0.12.0",
147
+ instructions: worldInstructions
148
+ });
149
+ for (const toolDef of tools) {
150
+ const executor = executors[toolDef.name];
151
+ if (!executor) {
152
+ throw new Error(`No executor for tool "${toolDef.name}"`);
153
+ }
154
+ server.addTool({
155
+ name: toolDef.name,
156
+ description: detail(toolDef.name),
157
+ parameters: toZodSchema(toolDef),
158
+ execute: async (params) => {
159
+ return await executor(params);
160
+ }
161
+ });
162
+ }
228
163
  server.start({
229
164
  transportType: "stdio"
230
165
  });
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts","../src/instructions.ts","../src/state.ts"],"sourcesContent":["/**\n * @rolexjs/mcp-server — individual-level MCP tools.\n *\n * Pure pass-through: all rendering happens in rolexjs.\n * MCP only translates protocol calls to API calls.\n */\n\nimport { genesis } from \"@rolexjs/genesis\";\nimport { localPlatform } from \"@rolexjs/local-platform\";\nimport { FastMCP } from \"fastmcp\";\nimport { createRoleX, detail, type ProjectAction, renderProjectResult, type State } from \"rolexjs\";\n\nimport { z } from \"zod\";\nimport { instructions } from \"./instructions.js\";\nimport { McpState } from \"./state.js\";\n\n// ========== Setup ==========\n\nconst rolex = await createRoleX(\n localPlatform({\n prototypes: [genesis],\n })\n);\nconst state = new McpState();\n\n// ========== Server ==========\n\nconst server = new FastMCP({\n name: \"rolex\",\n version: \"0.12.0\",\n instructions,\n});\n\n// ========== Tools: Role ==========\n\nserver.addTool({\n name: \"activate\",\n description: detail(\"activate\"),\n parameters: z.object({\n roleId: z.string().describe(\"Role name to activate\"),\n }),\n execute: async ({ roleId }) => {\n try {\n const role = await rolex.activate(roleId);\n state.role = role;\n return await role.project();\n } catch {\n const census = await rolex.direct<string>(\"!census.list\");\n throw new Error(\n `\"${roleId}\" not found. Available:\\n\\n${census}\\n\\nTry again with the correct id or alias.`\n );\n }\n },\n});\n\nserver.addTool({\n name: \"focus\",\n description: detail(\"focus\"),\n parameters: z.object({\n id: z.string().optional().describe(\"Goal id to switch to. Omit to view current.\"),\n }),\n execute: async ({ id }) => {\n return await state.requireRole().focus(id);\n },\n});\n\n// ========== Tools: Execution ==========\n\nserver.addTool({\n name: \"want\",\n description: detail(\"want\"),\n parameters: z.object({\n id: z.string().describe(\"Goal id (used for focus/reference)\"),\n goal: z.string().describe(\"Gherkin Feature source describing the goal\"),\n }),\n execute: async ({ id, goal }) => {\n return await state.requireRole().want(goal, id);\n },\n});\n\nserver.addTool({\n name: \"plan\",\n description: detail(\"plan\"),\n parameters: z.object({\n id: z.string().describe(\"Plan id — keywords from the plan content joined by hyphens\"),\n plan: z.string().describe(\"Gherkin Feature source describing the plan\"),\n after: z\n .string()\n .optional()\n .describe(\"Plan id this plan follows (sequential/phase relationship)\"),\n fallback: z\n .string()\n .optional()\n .describe(\"Plan id this plan is a backup for (alternative/strategy relationship)\"),\n }),\n execute: async ({ id, plan, after, fallback }) => {\n return await state.requireRole().plan(plan, id, after, fallback);\n },\n});\n\nserver.addTool({\n name: \"todo\",\n description: detail(\"todo\"),\n parameters: z.object({\n id: z.string().describe(\"Task id (used for finish/reference)\"),\n task: z.string().describe(\"Gherkin Feature source describing the task\"),\n }),\n execute: async ({ id, task }) => {\n return await state.requireRole().todo(task, id);\n },\n});\n\nserver.addTool({\n name: \"finish\",\n description: detail(\"finish\"),\n parameters: z.object({\n id: z.string().describe(\"Task id to finish\"),\n encounter: z.string().optional().describe(\"Optional Gherkin Feature describing what happened\"),\n }),\n execute: async ({ id, encounter }) => {\n return await state.requireRole().finish(id, encounter);\n },\n});\n\nserver.addTool({\n name: \"complete\",\n description: detail(\"complete\"),\n parameters: z.object({\n id: z.string().optional().describe(\"Plan id to complete (defaults to focused plan)\"),\n encounter: z.string().optional().describe(\"Optional Gherkin Feature describing what happened\"),\n }),\n execute: async ({ id, encounter }) => {\n return await state.requireRole().complete(id, encounter);\n },\n});\n\nserver.addTool({\n name: \"abandon\",\n description: detail(\"abandon\"),\n parameters: z.object({\n id: z.string().optional().describe(\"Plan id to abandon (defaults to focused plan)\"),\n encounter: z.string().optional().describe(\"Optional Gherkin Feature describing what happened\"),\n }),\n execute: async ({ id, encounter }) => {\n return await state.requireRole().abandon(id, encounter);\n },\n});\n\n// ========== Tools: Cognition ==========\n\nserver.addTool({\n name: \"reflect\",\n description: detail(\"reflect\"),\n parameters: z.object({\n ids: z.array(z.string()).describe(\"Encounter ids to reflect on (selective consumption)\"),\n id: z\n .string()\n .describe(\"Experience id — keywords from the experience content joined by hyphens\"),\n experience: z.string().optional().describe(\"Gherkin Feature source for the experience\"),\n }),\n execute: async ({ ids, id, experience }) => {\n return await state.requireRole().reflect(ids, experience, id);\n },\n});\n\nserver.addTool({\n name: \"realize\",\n description: detail(\"realize\"),\n parameters: z.object({\n ids: z.array(z.string()).describe(\"Experience ids to distill into a principle\"),\n id: z.string().describe(\"Principle id — keywords from the principle content joined by hyphens\"),\n principle: z.string().optional().describe(\"Gherkin Feature source for the principle\"),\n }),\n execute: async ({ ids, id, principle }) => {\n return await state.requireRole().realize(ids, principle, id);\n },\n});\n\nserver.addTool({\n name: \"master\",\n description: detail(\"master\"),\n parameters: z.object({\n ids: z.array(z.string()).optional().describe(\"Experience ids to distill into a procedure\"),\n id: z.string().describe(\"Procedure id — keywords from the procedure content joined by hyphens\"),\n procedure: z.string().describe(\"Gherkin Feature source for the procedure\"),\n }),\n execute: async ({ ids, id, procedure }) => {\n return await state.requireRole().master(procedure, id, ids);\n },\n});\n\n// ========== Tools: Knowledge management ==========\n\nserver.addTool({\n name: \"forget\",\n description: detail(\"forget\"),\n parameters: z.object({\n id: z\n .string()\n .describe(\"Id of the node to remove (principle, procedure, experience, encounter, etc.)\"),\n }),\n execute: async ({ id }) => {\n return await state.requireRole().forget(id);\n },\n});\n\n// ========== Tools: Skill loading ==========\n\nserver.addTool({\n name: \"skill\",\n description: detail(\"skill\"),\n parameters: z.object({\n locator: z\n .string()\n .describe(\"ResourceX locator for the skill (e.g. deepractice/role-management)\"),\n }),\n execute: async ({ locator }) => {\n return await state.requireRole().skill(locator);\n },\n});\n\n// ========== Tools: Use ==========\n\nserver.addTool({\n name: \"use\",\n description: detail(\"use\"),\n parameters: z\n .object({\n command: z\n .string()\n .describe(\"!namespace.method for RoleX commands, or a ResourceX locator for resources\"),\n })\n .catchall(z.unknown()),\n execute: async (params) => {\n const { command, ...args } = params;\n const result = await state\n .requireRole()\n .use(command as string, Object.keys(args).length > 0 ? args : undefined);\n if (result == null) return `${command} done.`;\n if (typeof result === \"string\") return result;\n return JSON.stringify(result, null, 2);\n },\n});\n\n// ========== Tools: Direct ==========\n\nserver.addTool({\n name: \"direct\",\n description: detail(\"direct\"),\n parameters: z\n .object({\n command: z\n .string()\n .describe(\"!namespace.method for RoleX commands, or a ResourceX locator for resources\"),\n })\n .catchall(z.unknown()),\n execute: async (params) => {\n const { command, ...args } = params;\n const result = await rolex.direct(\n command as string,\n Object.keys(args).length > 0 ? args : undefined\n );\n if (result == null) return `${command} done.`;\n if (typeof result === \"string\") return result;\n // Render project results as readable text\n if ((command as string).startsWith(\"!project.\")) {\n const action = (command as string).slice(\"!project.\".length) as ProjectAction;\n const opResult = result as { state: State };\n return renderProjectResult(action, opResult.state);\n }\n return JSON.stringify(result, null, 2);\n },\n});\n\n// ========== Start ==========\n\nserver.start({\n transportType: \"stdio\",\n});\n","/**\n * MCP server instructions — the cognitive framework for AI roles.\n *\n * Assembled from world .feature files in rolexjs descriptions.\n * Each feature describes one independent concern of the RoleX framework.\n */\nimport { world } from \"rolexjs\";\n\nexport const instructions = Object.values(world).join(\"\\n\\n\");\n","/**\n * McpState — thin session holder for the MCP server.\n *\n * Holds the active Role handle. All business logic (state tracking,\n * cognitive hints, encounter/experience registries) lives in Role + RoleContext.\n */\nimport type { Role } from \"rolexjs\";\n\nexport class McpState {\n role: Role | null = null;\n\n requireRole(): Role {\n if (!this.role) throw new Error(\"No active role. Call activate first.\");\n return this.role;\n }\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/index.ts","../src/state.ts"],"sourcesContent":["/**\n * @rolexjs/mcp-server — individual-level MCP tools.\n *\n * Pure pass-through: all rendering happens in rolexjs.\n * MCP only translates protocol calls to API calls.\n *\n * Tool schemas are defined once in @rolexjs/prototype (tools)\n * and converted to Zod here for FastMCP registration.\n */\n\nimport { genesis } from \"@rolexjs/genesis\";\nimport { localPlatform } from \"@rolexjs/local-platform\";\nimport { FastMCP } from \"fastmcp\";\nimport {\n createRoleX,\n detail,\n type ParamDef,\n type ProjectAction,\n renderProjectResult,\n type State,\n type ToolDef,\n tools,\n worldInstructions,\n} from \"rolexjs\";\n\nimport { z } from \"zod\";\nimport { McpState } from \"./state.js\";\n\n// ========== Setup ==========\n\nconst rolex = await createRoleX(\n localPlatform({\n prototypes: [genesis],\n })\n);\nconst state = new McpState();\n\n// ========== Zod conversion ==========\n\nfunction paramToZod(param: ParamDef, required: boolean): z.ZodTypeAny {\n let zodType: z.ZodTypeAny;\n switch (param.type) {\n case \"string\":\n case \"gherkin\":\n zodType = z.string();\n break;\n case \"string[]\":\n zodType = z.array(z.string());\n break;\n case \"number\":\n zodType = z.number();\n break;\n case \"record\":\n zodType = z.record(z.unknown());\n break;\n default:\n zodType = z.unknown();\n }\n zodType = zodType.describe(param.description);\n if (!required) zodType = zodType.optional();\n return zodType;\n}\n\nfunction toZodSchema(def: ToolDef): z.ZodTypeAny {\n const shape: Record<string, z.ZodTypeAny> = {};\n for (const [key, param] of Object.entries(def.params)) {\n shape[key] = paramToZod(param, param.required);\n }\n const schema = z.object(shape);\n return def.additionalProperties ? schema.catchall(z.unknown()) : schema;\n}\n\n// ========== Tool execution ==========\n\ntype ToolExecutor = (params: Record<string, unknown>) => Promise<string>;\n\nconst executors: Record<string, ToolExecutor> = {\n async activate({ roleId }) {\n try {\n const role = await rolex.activate(roleId as string);\n state.role = role;\n return await role.project();\n } catch {\n const census = await rolex.direct<string>(\"!census.list\");\n throw new Error(\n `\"${roleId}\" not found. Available:\\n\\n${census}\\n\\nTry again with the correct id or alias.`\n );\n }\n },\n\n async focus({ id }) {\n return await state.requireRole().focus(id as string | undefined);\n },\n\n async want({ id, goal }) {\n return await state.requireRole().want(goal as string, id as string);\n },\n\n async plan({ id, plan, after, fallback }) {\n return await state\n .requireRole()\n .plan(\n plan as string,\n id as string,\n after as string | undefined,\n fallback as string | undefined\n );\n },\n\n async todo({ id, task }) {\n return await state.requireRole().todo(task as string, id as string);\n },\n\n async finish({ id, encounter }) {\n return await state.requireRole().finish(id as string, encounter as string | undefined);\n },\n\n async complete({ id, encounter }) {\n return await state\n .requireRole()\n .complete(id as string | undefined, encounter as string | undefined);\n },\n\n async abandon({ id, encounter }) {\n return await state\n .requireRole()\n .abandon(id as string | undefined, encounter as string | undefined);\n },\n\n async reflect({ ids, id, experience }) {\n return await state\n .requireRole()\n .reflect(ids as string[], experience as string | undefined, id as string);\n },\n\n async realize({ ids, id, principle }) {\n return await state\n .requireRole()\n .realize(ids as string[], principle as string | undefined, id as string);\n },\n\n async master({ ids, id, procedure }) {\n return await state\n .requireRole()\n .master(procedure as string, id as string, ids as string[] | undefined);\n },\n\n async forget({ id }) {\n return await state.requireRole().forget(id as string);\n },\n\n async skill({ locator }) {\n return await state.requireRole().skill(locator as string);\n },\n\n async use(params) {\n const { command, ...args } = params;\n const result = await state\n .requireRole()\n .use(command as string, Object.keys(args).length > 0 ? args : undefined);\n if (result == null) return `${command} done.`;\n if (typeof result === \"string\") return result;\n return JSON.stringify(result, null, 2);\n },\n\n async direct(params) {\n const { command, ...args } = params;\n const result = await rolex.direct(\n command as string,\n Object.keys(args).length > 0 ? args : undefined\n );\n if (result == null) return `${command} done.`;\n if (typeof result === \"string\") return result;\n if ((command as string).startsWith(\"!project.\")) {\n const action = (command as string).slice(\"!project.\".length) as ProjectAction;\n const opResult = result as { state: State };\n return renderProjectResult(action, opResult.state);\n }\n return JSON.stringify(result, null, 2);\n },\n};\n\n// ========== Server ==========\n\nconst server = new FastMCP({\n name: \"rolex\",\n version: \"0.12.0\",\n instructions: worldInstructions,\n});\n\n// Register all tools from unified schema\nfor (const toolDef of tools) {\n const executor = executors[toolDef.name];\n if (!executor) {\n throw new Error(`No executor for tool \"${toolDef.name}\"`);\n }\n\n server.addTool({\n name: toolDef.name,\n description: detail(toolDef.name),\n parameters: toZodSchema(toolDef),\n execute: async (params) => {\n return await executor(params as Record<string, unknown>);\n },\n });\n}\n\n// ========== Start ==========\n\nserver.start({\n transportType: \"stdio\",\n});\n","/**\n * McpState — thin session holder for the MCP server.\n *\n * Holds the active Role handle. All business logic (state tracking,\n * cognitive hints, encounter/experience registries) lives in Role + RoleContext.\n */\nimport type { Role } from \"rolexjs\";\n\nexport class McpState {\n role: Role | null = null;\n\n requireRole(): Role {\n if (!this.role) throw new Error(\"No active role. Call activate first.\");\n return this.role;\n }\n}\n"],"mappings":"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","names":[]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rolexjs/mcp-server",
3
- "version": "1.4.0-dev-20260305012717",
3
+ "version": "1.4.0-dev-20260305032702",
4
4
  "description": "MCP server for Rolex — expose RDD role management as MCP tools",
5
5
  "keywords": [
6
6
  "rolex",
@@ -41,9 +41,9 @@
41
41
  "clean": "rm -rf dist"
42
42
  },
43
43
  "dependencies": {
44
- "rolexjs": "1.4.0-dev-20260305012717",
45
- "@rolexjs/local-platform": "1.4.0-dev-20260305012717",
46
- "@rolexjs/genesis": "1.4.0-dev-20260305012717",
44
+ "rolexjs": "1.4.0-dev-20260305032702",
45
+ "@rolexjs/local-platform": "1.4.0-dev-20260305032702",
46
+ "@rolexjs/genesis": "1.4.0-dev-20260305032702",
47
47
  "fastmcp": "^3.0.0",
48
48
  "zod": "^3.25.0"
49
49
  },