@sodiumhq/mcp-pm 0.1.0-beta.6299 → 0.1.0-beta.6353

package/dist/http.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as buildServer } from "./src-b0BBk3Y8.mjs";
+import { t as buildServer } from "./src-C2ETa30c.mjs";
 import { createRequire } from "node:module";
 import { SUPPORTED_PROTOCOL_VERSIONS, createMcpHandler } from "@modelcontextprotocol/server";
 import { createHash, randomUUID } from "node:crypto";

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as buildServer } from "./src-b0BBk3Y8.mjs";
+import { t as buildServer } from "./src-C2ETa30c.mjs";
 import { createRequire } from "node:module";
 import { serveStdio } from "@modelcontextprotocol/server/stdio";
 import { parseArgs } from "node:util";

package/dist/{src-b0BBk3Y8.mjs → src-C2ETa30c.mjs}

@@ -2491,6 +2491,16 @@ var SodiumApiClient = class {
 		if (error !== void 0 || !data) throw this.toError(response, error, correlationId, "get current user");
 		return data;
 	}
+	async getCurrentTenantUserCode() {
+		const me = await this.getCurrentUser();
+		if (!me.code || !me.email) throw new Error("Could not work out who you are signed in as.");
+		const tenantUser = (await this.listUsers({
+			search: me.email,
+			limit: 50
+		})).data?.find((u) => u.userCode === me.code);
+		if (!tenantUser?.code) throw new Error(`You are not a user of practice '${this.tenant}'.`);
+		return tenantUser.code;
+	}
 	async listClients(query = {}) {
 		const correlationId = randomUUID();
 		const { data, error, response } = await listClients({
@@ -3809,8 +3819,9 @@ var SodiumApiClient = class {
 //#region ../mcp-core/src/context/instructions.ts
 const ROSTER_CAP = 20;
 async function buildInstructions(api, ctx, selection) {
-	const [user, tenant, practice, team] = await Promise.allSettled([
+	const [user, userCode, tenant, practice, team] = await Promise.allSettled([
 		api.getCurrentUser(),
+		api.getCurrentTenantUserCode(),
 		api.getTenantDetails(),
 		api.getPracticeDetails(),
 		api.listUsers({
@@ -3845,13 +3856,13 @@ async function buildInstructions(api, ctx, selection) {
 		`Current UTC time: ${now.toISOString()}`
 	];
 	if (user.status === "fulfilled") {
-		const name = user.value.fullName ?? user.value.email ?? user.value.code ?? "unknown";
-		lines.push(`Current user: ${name}${user.value.code ? ` (${user.value.code})` : ""}`);
+		const name = user.value.fullName ?? user.value.email ?? "unknown";
+		lines.push(`Current user: ${name}${userCode.status === "fulfilled" ? ` (${userCode.value})` : ""}`);
 	}
 	if (tenant.status === "fulfilled") lines.push(`Tenant: ${tenant.value.name} (${tenant.value.code})`);
 	if (practice.status === "fulfilled") lines.push(`Practice: ${practice.value.name}`);
 	if (selection.kind === "choice") {
-		lines.push("", "PRACTICE SELECTION — this user belongs to more than one practice.", "Data tools take an optional 'practice' argument (a practice code). Ask the user which practice to work in, then pass its code on EVERY tool call for the rest of the conversation. Calls without it are refused with a reminder.");
+		lines.push("", "PRACTICE SELECTION — this user belongs to more than one practice.", "Data tools take an optional 'practice' argument (a practice code). Ask the user which practice to work in, then pass its code on EVERY tool call for the rest of the conversation. Calls without it are refused with a reminder.", "The user's own code differs in each practice. For 'my tasks' / 'my time' style filters, call whoami with the chosen practice and use the user code it shows.");
 		if (selection.practices.length > 0) {
 			lines.push("Practices available:");
 			for (const p of selection.practices) lines.push(`- ${p.name} (${p.code})`);
@@ -5122,11 +5133,11 @@ const AddTaskNoteInputSchema = {
 };
 async function handleAddTaskNote(api, args) {
 	try {
-		const user = await api.getCurrentUser();
+		const authorCode = await api.getCurrentTenantUserCode();
 		const note = await api.createTaskNote(args.taskCode, {
 			text: args.text,
 			date: (/* @__PURE__ */ new Date()).toISOString(),
-			noteFromUserCode: user.code ?? "",
+			noteFromUserCode: authorCode,
 			pinnedLevel: args.pinnedLevel ?? 0
 		});
 		return { content: [{
@@ -6015,8 +6026,9 @@ async function handleUpdateContact(api, args) {
 //#region ../mcp-core/src/tools/whoami.ts
 async function handleWhoami(api) {
 	try {
-		const [userResult, tenantResult, practiceResult] = await Promise.allSettled([
+		const [userResult, userCodeResult, tenantResult, practiceResult] = await Promise.allSettled([
 			api.getCurrentUser(),
+			api.getCurrentTenantUserCode(),
 			api.getTenantDetails(),
 			api.getPracticeDetails()
 		]);
@@ -6026,7 +6038,8 @@ async function handleWhoami(api) {
 			lines.push("--- User ---");
 			lines.push(`Name: ${u.fullName ?? "(not set)"}`);
 			lines.push(`Email: ${u.email ?? "(not set)"}`);
-			lines.push(`Code: ${u.code ?? "(not set)"}`);
+			if (userCodeResult.status === "fulfilled") lines.push(`Practice user code: ${userCodeResult.value}`);
+			lines.push(`Platform user code (not accepted by practice filters): ${u.code ?? "(not set)"}`);
 			lines.push(`Email verified: ${u.isEmailVerified ? "yes" : "no"}`);
 			lines.push(`Auth provider: ${u.authProvider ?? "(not set)"}`);
 			if (u.isSuperAdmin) lines.push("Super admin: yes");
@@ -9376,15 +9389,25 @@ function captureClientInfo(server, api) {
 		version: info.version
 	});
 }
+function withAnnotationTitle(config) {
+	if (!config.title) return config;
+	return {
+		...config,
+		annotations: {
+			title: config.title,
+			...config.annotations
+		}
+	};
+}
 function registerTenantTool(server, api, name, config, cb) {
 	const inputSchema = {
 		...config.inputSchema ?? {},
 		practice: practiceField
 	};
-	server.registerTool(name, {
+	server.registerTool(name, withAnnotationTitle({
 		...config,
 		inputSchema
-	}, async (args, extra) => {
+	}), async (args, extra) => {
 		const started = Date.now();
 		captureClientInfo(server, api);
 		const { practice, ...rest } = args;
@@ -9464,21 +9487,21 @@ async function buildServer(config) {
 			openWorldHint: true
 		}
 	}, () => handleGetPracticeDetails(api));
-	server.registerTool("whoami", {
+	server.registerTool("whoami", withAnnotationTitle({
 		title: "Show current user and tenant info",
-		description: "Returns the identity of the authenticated user (name, email, code), the tenant/practice the call runs against (name, code, status), and the practice name. Use this when the user asks 'who am I?', 'which tenant am I connected to?', 'what account is this?', or when debugging authentication/permission issues. The optional 'practice' argument picks the practice section shown; without it the user's lone practice is used, and the identity section still answers when no practice can be resolved.",
+		description: "Returns the identity of the authenticated user (name, email, and their user code in the practice, which is the code to use for 'my tasks' / 'my time' filters and 'assign to me'), the tenant/practice the call runs against (name, code, status), and the practice name. Use this when the user asks 'who am I?', 'which tenant am I connected to?', 'what account is this?', or when debugging authentication/permission issues. The optional 'practice' argument picks the practice section shown; without it the user's lone practice is used, and the identity section still answers when no practice can be resolved.",
 		inputSchema: { practice: practiceField },
 		annotations: {
 			readOnlyHint: true,
 			idempotentHint: true,
 			openWorldHint: true
 		}
-	}, async (args) => {
+	}), async (args) => {
 		captureClientInfo(server, api);
 		await resolveTenantForCall(api, args.practice);
 		return handleWhoami(api);
 	});
-	server.registerTool("list_practices", {
+	server.registerTool("list_practices", withAnnotationTitle({
 		title: "List the practices you can work in",
 		description: "List the practices (tenants) the signed-in user belongs to. Use this when the user belongs to more than one practice and you need the codes to pass in other tools' 'practice' argument, or when the user asks 'which practices can I access?'. Practices flagged 'unavailable' cannot be worked in.",
 		inputSchema: {},
@@ -9487,7 +9510,7 @@ async function buildServer(config) {
 			idempotentHint: true,
 			openWorldHint: true
 		}
-	}, () => {
+	}), () => {
 		captureClientInfo(server, api);
 		return handleListPractices(api);
 	});
@@ -9694,7 +9717,7 @@ async function buildServer(config) {
 		inputSchema: ListWorkflowOccurrencesInputSchema,
 		annotations: reportAnnotations
 	}, (args) => handleListWorkflowOccurrences(api, args));
-	server.registerTool("get_usage_examples", {
+	server.registerTool("get_usage_examples", withAnnotationTitle({
 		title: "Show example prompts for this integration",
 		description: "Returns a curated cookbook of example prompts this Sodium integration answers well, grouped by topic (daily-workflow, clients, tasks-and-deadlines, client-requests, time-tracking, reports, companies-house, proposals-and-engagements, making-changes). Use when the user asks 'what can you do?', 'what can I ask about my Sodium data?', 'give me some examples', or seems unsure how to get value from the integration. Also useful onboarding a new user: show the overview, then drill into the topic nearest their role. Static content — makes no API call.",
 		inputSchema: GetUsageExamplesInputSchema,
@@ -9703,7 +9726,7 @@ async function buildServer(config) {
 			idempotentHint: true,
 			openWorldHint: false
 		}
-	}, (args) => handleGetUsageExamples(args));
+	}), (args) => handleGetUsageExamples(args));
 	const lookupAnnotations = {
 		readOnlyHint: true,
 		idempotentHint: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sodiumhq/mcp-pm",
-  "version": "0.1.0-beta.6299",
+  "version": "0.1.0-beta.6353",
   "description": "Sodium Practice Management MCP server — lets AI assistants interact with your Sodium tenant",
   "type": "module",
   "bin": {