@headless-lms/server 0.2.0 → 0.3.0

package/dist/http/mcp/tools/community-moderation.js

@@ -0,0 +1,144 @@
+import { CommunityChatParam, CommunityCommentParam, CommunityIdParam, CommunityMessageParam, CommunityPostParam, CommunitySpaceParam } from "../../schemas/community.js";
+import { ResolvePostFlags } from "../../schemas/posts.js";
+import { ResolveMessageFlags } from "../../schemas/chats.js";
+import "../../schemas/index.js";
+import { actor, defineTool } from "../tool.js";
+//#region src/http/mcp/tools/community-moderation.ts
+const communityModerationTools = [
+	defineTool({
+		name: "get_space_moderation_queue",
+		title: "Get space moderation queue",
+		description: "The posts awaiting review in a space and the open flags on its posts and comments. Each list holds at most the 100 oldest; working the queue brings in the next ones.",
+		scope: "community_moderation:read",
+		kind: "read",
+		idempotent: true,
+		openWorld: false,
+		input: CommunitySpaceParam,
+		call: ({ communityId, spaceId }, { container, scope }) => container.posts.moderationQueue(scope.orgId, actor(scope), communityId, spaceId)
+	}),
+	defineTool({
+		name: "get_message_moderation_queue",
+		title: "Get message moderation queue",
+		description: "The messages in a community's chats with open flags, with the flags and the chat each is in. Holds at most the 100 oldest open flags.",
+		scope: "community_moderation:read",
+		kind: "read",
+		idempotent: true,
+		openWorld: false,
+		input: CommunityIdParam,
+		call: ({ communityId }, { container, scope }) => container.chats.messageQueue(scope.orgId, actor(scope), communityId)
+	}),
+	defineTool({
+		name: "approve_post",
+		title: "Approve post",
+		description: "Publish a post that is awaiting review.",
+		scope: "community_moderation:write",
+		kind: "write",
+		idempotent: true,
+		openWorld: false,
+		input: CommunityPostParam,
+		call: ({ communityId, postId }, { container, scope }) => container.posts.approve(scope.orgId, postId, actor(scope), communityId)
+	}),
+	defineTool({
+		name: "dismiss_post_flags",
+		title: "Dismiss post flags",
+		description: "Close every open flag on a post and leave it up.",
+		scope: "community_moderation:write",
+		kind: "write",
+		idempotent: true,
+		openWorld: false,
+		input: ResolvePostFlags.extend(CommunityPostParam.shape),
+		call: ({ communityId, postId, resolution }, { container, scope }) => container.posts.resolveFlags(scope.orgId, postId, actor(scope), resolution, communityId)
+	}),
+	defineTool({
+		name: "remove_post",
+		title: "Remove post",
+		description: "Take a published or pending post down and resolve its open flags as removed. restore_post brings it back.",
+		scope: "community_moderation:write",
+		kind: "destructive",
+		idempotent: true,
+		openWorld: false,
+		input: CommunityPostParam,
+		call: ({ communityId, postId }, { container, scope }) => container.posts.remove(scope.orgId, postId, actor(scope), communityId)
+	}),
+	defineTool({
+		name: "restore_post",
+		title: "Restore post",
+		description: "Put a removed post back up.",
+		scope: "community_moderation:write",
+		kind: "write",
+		idempotent: true,
+		openWorld: false,
+		input: CommunityPostParam,
+		call: ({ communityId, postId }, { container, scope }) => container.posts.restore(scope.orgId, postId, actor(scope), communityId)
+	}),
+	defineTool({
+		name: "dismiss_post_comment_flags",
+		title: "Dismiss post comment flags",
+		description: "Close every open flag on a comment on a post and leave it up.",
+		scope: "community_moderation:write",
+		kind: "write",
+		idempotent: true,
+		openWorld: false,
+		input: CommunityCommentParam,
+		call: ({ communityId, commentId }, { container, scope }) => container.discussion.resolveReports(scope.orgId, commentId, actor(scope), communityId)
+	}),
+	defineTool({
+		name: "remove_post_comment",
+		title: "Remove post comment",
+		description: "Hide a comment on a post and resolve its open flags as removed. restore_post_comment brings it back.",
+		scope: "community_moderation:write",
+		kind: "destructive",
+		idempotent: true,
+		openWorld: false,
+		input: CommunityCommentParam,
+		call: ({ communityId, commentId }, { container, scope }) => container.discussion.remove(scope.orgId, commentId, actor(scope), communityId)
+	}),
+	defineTool({
+		name: "restore_post_comment",
+		title: "Restore post comment",
+		description: "Publish a removed comment on a post again.",
+		scope: "community_moderation:write",
+		kind: "write",
+		idempotent: true,
+		openWorld: false,
+		input: CommunityCommentParam,
+		call: ({ communityId, commentId }, { container, scope }) => container.discussion.restore(scope.orgId, commentId, actor(scope), communityId)
+	}),
+	defineTool({
+		name: "dismiss_message_flags",
+		title: "Dismiss message flags",
+		description: "Close every open flag on a chat message and leave it up.",
+		scope: "community_moderation:write",
+		kind: "write",
+		idempotent: true,
+		openWorld: false,
+		input: ResolveMessageFlags.extend(CommunityMessageParam.shape),
+		call: ({ communityId, messageId, resolution }, { container, scope }) => container.chats.resolveMessageFlags(scope.orgId, actor(scope), messageId, resolution, communityId)
+	}),
+	defineTool({
+		name: "lock_chat",
+		title: "Lock chat",
+		description: "Stop everyone sending or editing messages in a chat until it is unlocked. Its open message flags are resolved as locked.",
+		scope: "community_moderation:write",
+		kind: "destructive",
+		idempotent: true,
+		openWorld: false,
+		input: CommunityChatParam,
+		call: ({ communityId, chatId }, { container, scope }) => container.chats.lock(scope.orgId, actor(scope), chatId, communityId)
+	}),
+	defineTool({
+		name: "unlock_chat",
+		title: "Unlock chat",
+		description: "Let the participants of a locked chat send messages again.",
+		scope: "community_moderation:write",
+		kind: "write",
+		idempotent: true,
+		openWorld: false,
+		input: CommunityChatParam,
+		call: ({ communityId, chatId }, { container, scope }) => container.chats.unlock(scope.orgId, actor(scope), chatId, communityId)
+	})
+];
+//#endregion
+export { communityModerationTools };
+
+//# sourceMappingURL=community-moderation.js.map

package/dist/http/mcp/tools/community-moderation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"community-moderation.js","names":[],"sources":["../../../../src/http/mcp/tools/community-moderation.ts"],"sourcesContent":["import {\n  CommunityChatParam,\n  CommunityCommentParam,\n  CommunityIdParam,\n  CommunityMessageParam,\n  CommunityPostParam,\n  CommunitySpaceParam,\n  ResolveMessageFlags,\n  ResolvePostFlags,\n} from '../../schemas/index.js';\nimport { actor, defineTool, type Tool } from '../tool.js';\n\nexport const communityModerationTools: Tool[] = [\n  defineTool({\n    name: 'get_space_moderation_queue',\n    title: 'Get space moderation queue',\n    description:\n      'The posts awaiting review in a space and the open flags on its posts and comments. Each list holds at most the 100 oldest; working the queue brings in the next ones.',\n    scope: 'community_moderation:read',\n    kind: 'read',\n    idempotent: true,\n    openWorld: false,\n    input: CommunitySpaceParam,\n    call: ({ communityId, spaceId }, { container, scope }) =>\n      container.posts.moderationQueue(scope.orgId, actor(scope), communityId, spaceId),\n  }),\n  defineTool({\n    name: 'get_message_moderation_queue',\n    title: 'Get message moderation queue',\n    description:\n      \"The messages in a community's chats with open flags, with the flags and the chat each is in. Holds at most the 100 oldest open flags.\",\n    scope: 'community_moderation:read',\n    kind: 'read',\n    idempotent: true,\n    openWorld: false,\n    input: CommunityIdParam,\n    call: ({ communityId }, { container, scope }) =>\n      container.chats.messageQueue(scope.orgId, actor(scope), communityId),\n  }),\n  defineTool({\n    name: 'approve_post',\n    title: 'Approve post',\n    description: 'Publish a post that is awaiting review.',\n    scope: 'community_moderation:write',\n    kind: 'write',\n    idempotent: true,\n    openWorld: false,\n    input: CommunityPostParam,\n    call: ({ communityId, postId }, { container, scope }) =>\n      container.posts.approve(scope.orgId, postId, actor(scope), communityId),\n  }),\n  defineTool({\n    name: 'dismiss_post_flags',\n    title: 'Dismiss post flags',\n    description: 'Close every open flag on a post and leave it up.',\n    scope: 'community_moderation:write',\n    kind: 'write',\n    idempotent: true,\n    openWorld: false,\n    input: ResolvePostFlags.extend(CommunityPostParam.shape),\n    call: ({ communityId, postId, resolution }, { container, scope }) =>\n      container.posts.resolveFlags(scope.orgId, postId, actor(scope), resolution, communityId),\n  }),\n  defineTool({\n    name: 'remove_post',\n    title: 'Remove post',\n    description:\n      'Take a published or pending post down and resolve its open flags as removed. restore_post brings it back.',\n    scope: 'community_moderation:write',\n    kind: 'destructive',\n    idempotent: true,\n    openWorld: false,\n    input: CommunityPostParam,\n    call: ({ communityId, postId }, { container, scope }) =>\n      container.posts.remove(scope.orgId, postId, actor(scope), communityId),\n  }),\n  defineTool({\n    name: 'restore_post',\n    title: 'Restore post',\n    description: 'Put a removed post back up.',\n    scope: 'community_moderation:write',\n    kind: 'write',\n    idempotent: true,\n    openWorld: false,\n    input: CommunityPostParam,\n    call: ({ communityId, postId }, { container, scope }) =>\n      container.posts.restore(scope.orgId, postId, actor(scope), communityId),\n  }),\n  defineTool({\n    name: 'dismiss_post_comment_flags',\n    title: 'Dismiss post comment flags',\n    description: 'Close every open flag on a comment on a post and leave it up.',\n    scope: 'community_moderation:write',\n    kind: 'write',\n    idempotent: true,\n    openWorld: false,\n    input: CommunityCommentParam,\n    call: ({ communityId, commentId }, { container, scope }) =>\n      container.discussion.resolveReports(scope.orgId, commentId, actor(scope), communityId),\n  }),\n  defineTool({\n    name: 'remove_post_comment',\n    title: 'Remove post comment',\n    description:\n      'Hide a comment on a post and resolve its open flags as removed. restore_post_comment brings it back.',\n    scope: 'community_moderation:write',\n    kind: 'destructive',\n    idempotent: true,\n    openWorld: false,\n    input: CommunityCommentParam,\n    call: ({ communityId, commentId }, { container, scope }) =>\n      container.discussion.remove(scope.orgId, commentId, actor(scope), communityId),\n  }),\n  defineTool({\n    name: 'restore_post_comment',\n    title: 'Restore post comment',\n    description: 'Publish a removed comment on a post again.',\n    scope: 'community_moderation:write',\n    kind: 'write',\n    idempotent: true,\n    openWorld: false,\n    input: CommunityCommentParam,\n    call: ({ communityId, commentId }, { container, scope }) =>\n      container.discussion.restore(scope.orgId, commentId, actor(scope), communityId),\n  }),\n  defineTool({\n    name: 'dismiss_message_flags',\n    title: 'Dismiss message flags',\n    description: 'Close every open flag on a chat message and leave it up.',\n    scope: 'community_moderation:write',\n    kind: 'write',\n    idempotent: true,\n    openWorld: false,\n    input: ResolveMessageFlags.extend(CommunityMessageParam.shape),\n    call: ({ communityId, messageId, resolution }, { container, scope }) =>\n      container.chats.resolveMessageFlags(\n        scope.orgId,\n        actor(scope),\n        messageId,\n        resolution,\n        communityId,\n      ),\n  }),\n  defineTool({\n    name: 'lock_chat',\n    title: 'Lock chat',\n    description:\n      'Stop everyone sending or editing messages in a chat until it is unlocked. Its open message flags are resolved as locked.',\n    scope: 'community_moderation:write',\n    kind: 'destructive',\n    idempotent: true,\n    openWorld: false,\n    input: CommunityChatParam,\n    call: ({ communityId, chatId }, { container, scope }) =>\n      container.chats.lock(scope.orgId, actor(scope), chatId, communityId),\n  }),\n  defineTool({\n    name: 'unlock_chat',\n    title: 'Unlock chat',\n    description: 'Let the participants of a locked chat send messages again.',\n    scope: 'community_moderation:write',\n    kind: 'write',\n    idempotent: true,\n    openWorld: false,\n    input: CommunityChatParam,\n    call: ({ communityId, chatId }, { container, scope }) =>\n      container.chats.unlock(scope.orgId, actor(scope), chatId, communityId),\n  }),\n];\n"],"mappings":"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"}

package/dist/http/mcp/tools/courses.d.ts

@@ -0,0 +1,6 @@
+import { Tool } from "../tool.js";
+//#region src/http/mcp/tools/courses.d.ts
+declare const courseTools: Tool[];
+//#endregion
+export { courseTools };
+//# sourceMappingURL=courses.d.ts.map

package/dist/http/mcp/tools/courses.js

@@ -0,0 +1,121 @@
+import { CoursesQuery, CreateCourse, PatchCourseSettings, UpdateCourse } from "../../schemas/content.js";
+import { CourseIdPathParam, CreateModule, ModulePathParam, ReorderInput, UpdateModule } from "../../schemas/activities.js";
+import "../../schemas/index.js";
+import { actor, defineTool } from "../tool.js";
+//#region src/http/mcp/tools/courses.ts
+const courseTools = [
+	defineTool({
+		name: "list_courses",
+		title: "List courses",
+		description: "Search and page through the courses, each with its status and settings. Filter by status or category.",
+		scope: "courses:read",
+		kind: "read",
+		idempotent: true,
+		openWorld: false,
+		input: CoursesQuery,
+		call: (input, { container, scope }) => container.content.listCourses(scope.orgId, input)
+	}),
+	defineTool({
+		name: "list_modules",
+		title: "List modules",
+		description: "The modules of a course, in order.",
+		scope: "courses:read",
+		kind: "read",
+		idempotent: true,
+		openWorld: false,
+		input: CourseIdPathParam,
+		call: ({ courseId }, { container, scope }) => container.content.listCourseModules(scope.orgId, courseId)
+	}),
+	defineTool({
+		name: "create_course",
+		title: "Create course",
+		description: "Create a draft course. Publish it with update_course.",
+		scope: "courses:write",
+		kind: "write",
+		idempotent: false,
+		openWorld: false,
+		input: CreateCourse,
+		call: (input, { container, scope }) => container.content.createCourse(scope.orgId, input)
+	}),
+	defineTool({
+		name: "update_course",
+		title: "Update course",
+		description: "Change a course title, description, category or cover image, or publish and unpublish it with status. Fields left out stay as they are.",
+		scope: "courses:write",
+		kind: "write",
+		idempotent: true,
+		openWorld: false,
+		input: UpdateCourse.extend(CourseIdPathParam.shape),
+		call: ({ courseId, ...patch }, { container, scope }) => container.content.updateCourse(scope.orgId, courseId, patch)
+	}),
+	defineTool({
+		name: "update_course_settings",
+		title: "Update course settings",
+		description: "Change course settings such as transcript downloads and comments. Settings left out stay as they are.",
+		scope: "courses:write",
+		kind: "write",
+		idempotent: true,
+		openWorld: false,
+		input: PatchCourseSettings.extend(CourseIdPathParam.shape),
+		call: ({ courseId, ...settings }, { container, scope }) => container.content.patchCourseSettings(scope.orgId, courseId, settings)
+	}),
+	defineTool({
+		name: "create_module",
+		title: "Create module",
+		description: "Add a module at the end of a course. Returns the course modules in order.",
+		scope: "courses:write",
+		kind: "write",
+		idempotent: false,
+		openWorld: false,
+		input: CreateModule.extend(CourseIdPathParam.shape),
+		call: ({ courseId, title }, { container, scope }) => container.content.createModule(scope.orgId, courseId, title)
+	}),
+	defineTool({
+		name: "rename_module",
+		title: "Rename module",
+		description: "Rename a module. Returns the course modules in order.",
+		scope: "courses:write",
+		kind: "write",
+		idempotent: true,
+		openWorld: false,
+		input: UpdateModule.extend(ModulePathParam.shape),
+		call: ({ courseId, moduleId, title }, { container, scope }) => container.content.updateModule(scope.orgId, courseId, moduleId, title)
+	}),
+	defineTool({
+		name: "reorder_modules",
+		title: "Reorder modules",
+		description: "Set the module order of a course. Pass every module id of the course in the new order.",
+		scope: "courses:write",
+		kind: "write",
+		idempotent: true,
+		openWorld: false,
+		input: ReorderInput.extend(CourseIdPathParam.shape),
+		call: ({ courseId, orderedIds }, { container, scope }) => container.content.reorderModules(scope.orgId, courseId, orderedIds)
+	}),
+	defineTool({
+		name: "delete_course",
+		title: "Delete course",
+		description: "Permanently delete a course with its modules and activities.",
+		scope: "courses:delete",
+		kind: "destructive",
+		idempotent: true,
+		openWorld: false,
+		input: CourseIdPathParam,
+		call: ({ courseId }, { container, scope }) => container.content.deleteCourse(scope.orgId, courseId, actor(scope))
+	}),
+	defineTool({
+		name: "delete_module",
+		title: "Delete module",
+		description: "Permanently delete a module with its activities. Returns the remaining modules in order.",
+		scope: "courses:delete",
+		kind: "destructive",
+		idempotent: true,
+		openWorld: false,
+		input: ModulePathParam,
+		call: ({ courseId, moduleId }, { container, scope }) => container.content.deleteModule(scope.orgId, courseId, moduleId)
+	})
+];
+//#endregion
+export { courseTools };
+
+//# sourceMappingURL=courses.js.map

package/dist/http/mcp/tools/courses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"courses.js","names":[],"sources":["../../../../src/http/mcp/tools/courses.ts"],"sourcesContent":["import {\n  CourseIdPathParam,\n  CoursesQuery,\n  CreateCourse,\n  CreateModule,\n  ModulePathParam,\n  PatchCourseSettings,\n  ReorderInput,\n  UpdateCourse,\n  UpdateModule,\n} from '../../schemas/index.js';\nimport { actor, defineTool, type Tool } from '../tool.js';\n\nexport const courseTools: Tool[] = [\n  defineTool({\n    name: 'list_courses',\n    title: 'List courses',\n    description:\n      'Search and page through the courses, each with its status and settings. Filter by status or category.',\n    scope: 'courses:read',\n    kind: 'read',\n    idempotent: true,\n    openWorld: false,\n    input: CoursesQuery,\n    call: (input, { container, scope }) => container.content.listCourses(scope.orgId, input),\n  }),\n  defineTool({\n    name: 'list_modules',\n    title: 'List modules',\n    description: 'The modules of a course, in order.',\n    scope: 'courses:read',\n    kind: 'read',\n    idempotent: true,\n    openWorld: false,\n    input: CourseIdPathParam,\n    call: ({ courseId }, { container, scope }) =>\n      container.content.listCourseModules(scope.orgId, courseId),\n  }),\n  defineTool({\n    name: 'create_course',\n    title: 'Create course',\n    description: 'Create a draft course. Publish it with update_course.',\n    scope: 'courses:write',\n    kind: 'write',\n    idempotent: false,\n    openWorld: false,\n    input: CreateCourse,\n    call: (input, { container, scope }) => container.content.createCourse(scope.orgId, input),\n  }),\n  defineTool({\n    name: 'update_course',\n    title: 'Update course',\n    description:\n      'Change a course title, description, category or cover image, or publish and unpublish it with status. Fields left out stay as they are.',\n    scope: 'courses:write',\n    kind: 'write',\n    idempotent: true,\n    openWorld: false,\n    input: UpdateCourse.extend(CourseIdPathParam.shape),\n    call: ({ courseId, ...patch }, { container, scope }) =>\n      container.content.updateCourse(scope.orgId, courseId, patch),\n  }),\n  defineTool({\n    name: 'update_course_settings',\n    title: 'Update course settings',\n    description:\n      'Change course settings such as transcript downloads and comments. Settings left out stay as they are.',\n    scope: 'courses:write',\n    kind: 'write',\n    idempotent: true,\n    openWorld: false,\n    input: PatchCourseSettings.extend(CourseIdPathParam.shape),\n    call: ({ courseId, ...settings }, { container, scope }) =>\n      container.content.patchCourseSettings(scope.orgId, courseId, settings),\n  }),\n  defineTool({\n    name: 'create_module',\n    title: 'Create module',\n    description: 'Add a module at the end of a course. Returns the course modules in order.',\n    scope: 'courses:write',\n    kind: 'write',\n    idempotent: false,\n    openWorld: false,\n    input: CreateModule.extend(CourseIdPathParam.shape),\n    call: ({ courseId, title }, { container, scope }) =>\n      container.content.createModule(scope.orgId, courseId, title),\n  }),\n  defineTool({\n    name: 'rename_module',\n    title: 'Rename module',\n    description: 'Rename a module. Returns the course modules in order.',\n    scope: 'courses:write',\n    kind: 'write',\n    idempotent: true,\n    openWorld: false,\n    input: UpdateModule.extend(ModulePathParam.shape),\n    call: ({ courseId, moduleId, title }, { container, scope }) =>\n      container.content.updateModule(scope.orgId, courseId, moduleId, title),\n  }),\n  defineTool({\n    name: 'reorder_modules',\n    title: 'Reorder modules',\n    description:\n      'Set the module order of a course. Pass every module id of the course in the new order.',\n    scope: 'courses:write',\n    kind: 'write',\n    idempotent: true,\n    openWorld: false,\n    input: ReorderInput.extend(CourseIdPathParam.shape),\n    call: ({ courseId, orderedIds }, { container, scope }) =>\n      container.content.reorderModules(scope.orgId, courseId, orderedIds),\n  }),\n  defineTool({\n    name: 'delete_course',\n    title: 'Delete course',\n    description: 'Permanently delete a course with its modules and activities.',\n    scope: 'courses:delete',\n    kind: 'destructive',\n    idempotent: true,\n    openWorld: false,\n    input: CourseIdPathParam,\n    call: ({ courseId }, { container, scope }) =>\n      container.content.deleteCourse(scope.orgId, courseId, actor(scope)),\n  }),\n  defineTool({\n    name: 'delete_module',\n    title: 'Delete module',\n    description:\n      'Permanently delete a module with its activities. Returns the remaining modules in order.',\n    scope: 'courses:delete',\n    kind: 'destructive',\n    idempotent: true,\n    openWorld: false,\n    input: ModulePathParam,\n    call: ({ courseId, moduleId }, { container, scope }) =>\n      container.content.deleteModule(scope.orgId, courseId, moduleId),\n  }),\n];\n"],"mappings":";;;;;AAaA,MAAa,cAAsB;CACjC,WAAW;EACT,MAAM;EACN,OAAO;EACP,aACE;EACF,OAAO;EACP,MAAM;EACN,YAAY;EACZ,WAAW;EACX,OAAO;EACP,OAAO,OAAO,EAAE,WAAW,YAAY,UAAU,QAAQ,YAAY,MAAM,OAAO,KAAK;CACzF,CAAC;CACD,WAAW;EACT,MAAM;EACN,OAAO;EACP,aAAa;EACb,OAAO;EACP,MAAM;EACN,YAAY;EACZ,WAAW;EACX,OAAO;EACP,OAAO,EAAE,YAAY,EAAE,WAAW,YAChC,UAAU,QAAQ,kBAAkB,MAAM,OAAO,QAAQ;CAC7D,CAAC;CACD,WAAW;EACT,MAAM;EACN,OAAO;EACP,aAAa;EACb,OAAO;EACP,MAAM;EACN,YAAY;EACZ,WAAW;EACX,OAAO;EACP,OAAO,OAAO,EAAE,WAAW,YAAY,UAAU,QAAQ,aAAa,MAAM,OAAO,KAAK;CAC1F,CAAC;CACD,WAAW;EACT,MAAM;EACN,OAAO;EACP,aACE;EACF,OAAO;EACP,MAAM;EACN,YAAY;EACZ,WAAW;EACX,OAAO,aAAa,OAAO,kBAAkB,KAAK;EAClD,OAAO,EAAE,UAAU,GAAG,SAAS,EAAE,WAAW,YAC1C,UAAU,QAAQ,aAAa,MAAM,OAAO,UAAU,KAAK;CAC/D,CAAC;CACD,WAAW;EACT,MAAM;EACN,OAAO;EACP,aACE;EACF,OAAO;EACP,MAAM;EACN,YAAY;EACZ,WAAW;EACX,OAAO,oBAAoB,OAAO,kBAAkB,KAAK;EACzD,OAAO,EAAE,UAAU,GAAG,YAAY,EAAE,WAAW,YAC7C,UAAU,QAAQ,oBAAoB,MAAM,OAAO,UAAU,QAAQ;CACzE,CAAC;CACD,WAAW;EACT,MAAM;EACN,OAAO;EACP,aAAa;EACb,OAAO;EACP,MAAM;EACN,YAAY;EACZ,WAAW;EACX,OAAO,aAAa,OAAO,kBAAkB,KAAK;EAClD,OAAO,EAAE,UAAU,SAAS,EAAE,WAAW,YACvC,UAAU,QAAQ,aAAa,MAAM,OAAO,UAAU,KAAK;CAC/D,CAAC;CACD,WAAW;EACT,MAAM;EACN,OAAO;EACP,aAAa;EACb,OAAO;EACP,MAAM;EACN,YAAY;EACZ,WAAW;EACX,OAAO,aAAa,OAAO,gBAAgB,KAAK;EAChD,OAAO,EAAE,UAAU,UAAU,SAAS,EAAE,WAAW,YACjD,UAAU,QAAQ,aAAa,MAAM,OAAO,UAAU,UAAU,KAAK;CACzE,CAAC;CACD,WAAW;EACT,MAAM;EACN,OAAO;EACP,aACE;EACF,OAAO;EACP,MAAM;EACN,YAAY;EACZ,WAAW;EACX,OAAO,aAAa,OAAO,kBAAkB,KAAK;EAClD,OAAO,EAAE,UAAU,cAAc,EAAE,WAAW,YAC5C,UAAU,QAAQ,eAAe,MAAM,OAAO,UAAU,UAAU;CACtE,CAAC;CACD,WAAW;EACT,MAAM;EACN,OAAO;EACP,aAAa;EACb,OAAO;EACP,MAAM;EACN,YAAY;EACZ,WAAW;EACX,OAAO;EACP,OAAO,EAAE,YAAY,EAAE,WAAW,YAChC,UAAU,QAAQ,aAAa,MAAM,OAAO,UAAU,MAAM,KAAK,CAAC;CACtE,CAAC;CACD,WAAW;EACT,MAAM;EACN,OAAO;EACP,aACE;EACF,OAAO;EACP,MAAM;EACN,YAAY;EACZ,WAAW;EACX,OAAO;EACP,OAAO,EAAE,UAAU,YAAY,EAAE,WAAW,YAC1C,UAAU,QAAQ,aAAa,MAAM,OAAO,UAAU,QAAQ;CAClE,CAAC;AACH"}

package/dist/http/mcp/tools/index.d.ts

@@ -0,0 +1,6 @@
+import { Tool } from "../tool.js";
+//#region src/http/mcp/tools/index.d.ts
+declare const TOOLS: Tool[];
+//#endregion
+export { TOOLS };
+//# sourceMappingURL=index.d.ts.map

package/dist/http/mcp/tools/index.js

@@ -0,0 +1,23 @@
+import { automationTools } from "./automations.js";
+import { catalogTools } from "./catalog.js";
+import { commentTools } from "./comments.js";
+import { communityMemberTools } from "./community-members.js";
+import { communityModerationTools } from "./community-moderation.js";
+import { communityTools } from "./communities.js";
+import { courseTools } from "./courses.js";
+import { peopleTools } from "./people.js";
+//#region src/http/mcp/tools/index.ts
+const TOOLS = [
+	...courseTools,
+	...catalogTools,
+	...peopleTools,
+	...automationTools,
+	...commentTools,
+	...communityTools,
+	...communityMemberTools,
+	...communityModerationTools
+];
+//#endregion
+export { TOOLS };
+
+//# sourceMappingURL=index.js.map

package/dist/http/mcp/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/http/mcp/tools/index.ts"],"sourcesContent":["import type { Tool } from '../tool.js';\nimport { automationTools } from './automations.js';\nimport { catalogTools } from './catalog.js';\nimport { commentTools } from './comments.js';\nimport { communityMemberTools } from './community-members.js';\nimport { communityModerationTools } from './community-moderation.js';\nimport { communityTools } from './communities.js';\nimport { courseTools } from './courses.js';\nimport { peopleTools } from './people.js';\n\nexport const TOOLS: Tool[] = [\n  ...courseTools,\n  ...catalogTools,\n  ...peopleTools,\n  ...automationTools,\n  ...commentTools,\n  ...communityTools,\n  ...communityMemberTools,\n  ...communityModerationTools,\n];\n"],"mappings":";;;;;;;;;AAUA,MAAa,QAAgB;CAC3B,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;AACL"}

package/dist/http/mcp/tools/people.d.ts

@@ -0,0 +1,6 @@
+import { Tool } from "../tool.js";
+//#region src/http/mcp/tools/people.d.ts
+declare const peopleTools: Tool[];
+//#endregion
+export { peopleTools };
+//# sourceMappingURL=people.d.ts.map

package/dist/http/mcp/tools/people.js

@@ -0,0 +1,145 @@
+import { CourseIdPathParam } from "../../schemas/activities.js";
+import { StudentIdParam, StudentsQuery } from "../../schemas/students.js";
+import { EntitlementIdParam, EntitlementsQuery, GrantEntitlement, SetEntitlementStatus } from "../../schemas/entitlements.js";
+import { CreateInvite, Invite } from "../../schemas/invites.js";
+import { EnrollmentSeriesQuery } from "../../schemas/dashboard.js";
+import "../../schemas/index.js";
+import { actor, defineTool, noInput } from "../tool.js";
+//#region src/http/mcp/tools/people.ts
+const peopleTools = [
+	defineTool({
+		name: "list_students",
+		title: "List students",
+		description: "Search and page through the students with their access count, average progress, status and last activity.",
+		scope: "students:read",
+		kind: "read",
+		idempotent: true,
+		openWorld: false,
+		input: StudentsQuery,
+		call: (input, { container, scope }) => container.reporting.admin.listStudents(scope.orgId, input)
+	}),
+	defineTool({
+		name: "invite_student",
+		title: "Invite student",
+		description: "Invite someone by email as a student. They exist as an invited student at once. sendEmail false skips the email.",
+		scope: "students:invite",
+		kind: "write",
+		idempotent: false,
+		openWorld: true,
+		input: CreateInvite.omit({ role: true }),
+		output: Invite,
+		call: (input, { container, scope }) => container.organizations.createInvite(actor(scope), {
+			orgId: scope.orgId,
+			inviterUserId: scope.userId,
+			role: "student",
+			...input
+		})
+	}),
+	defineTool({
+		name: "resend_student_invite",
+		title: "Resend student invite",
+		description: "Send a pending student's invite email again.",
+		scope: "students:invite",
+		kind: "write",
+		idempotent: false,
+		openWorld: true,
+		input: StudentIdParam,
+		call: ({ id }, { container, scope }) => container.organizations.resendStudentInvite(actor(scope), {
+			orgId: scope.orgId,
+			orgUserId: id,
+			inviterUserId: scope.userId
+		})
+	}),
+	defineTool({
+		name: "list_access",
+		title: "List access",
+		description: "Who has access to what. Filter by student (orgUserId), content, type or status.",
+		scope: "access:read",
+		kind: "read",
+		idempotent: true,
+		openWorld: false,
+		input: EntitlementsQuery,
+		call: (input, { container, scope }) => container.entitlements.list(scope.orgId, input)
+	}),
+	defineTool({
+		name: "grant_access",
+		title: "Grant access",
+		description: "Give a student access to one course, download or community (contentId) or to a bundle (bundleId), never both. expiresAt is a date-time, or null for no expiry.",
+		scope: "access:write",
+		kind: "write",
+		idempotent: false,
+		openWorld: false,
+		input: GrantEntitlement,
+		call: (input, { container, scope }) => container.entitlements.grant(scope.orgId, input)
+	}),
+	defineTool({
+		name: "set_access_status",
+		title: "Revoke or reinstate access",
+		description: "Revoke an access grant, or reinstate a revoked one.",
+		scope: "access:write",
+		kind: "destructive",
+		idempotent: true,
+		openWorld: false,
+		input: SetEntitlementStatus.extend(EntitlementIdParam.shape),
+		call: ({ id, status }, { container, scope }) => container.entitlements.setStatus(scope.orgId, id, status)
+	}),
+	defineTool({
+		name: "get_dashboard",
+		title: "Get dashboard",
+		description: "Published and draft course counts, active students, and access grants expiring soon.",
+		scope: "analytics:read",
+		kind: "read",
+		idempotent: true,
+		openWorld: false,
+		input: noInput,
+		call: (_input, { container, scope }) => container.reporting.admin.overview(scope.orgId)
+	}),
+	defineTool({
+		name: "get_enrollment_trend",
+		title: "Get enrollment trend",
+		description: "Daily enrollments across the organization for the last days (default 30, at most 365).",
+		scope: "analytics:read",
+		kind: "read",
+		idempotent: true,
+		openWorld: false,
+		input: EnrollmentSeriesQuery,
+		call: ({ days }, { container, scope }) => container.reporting.admin.enrollments(scope.orgId, days)
+	}),
+	defineTool({
+		name: "get_course_analytics",
+		title: "Get course analytics",
+		description: "Enrolled, started and completed counts, average progress and per-activity engagement for one course.",
+		scope: "analytics:read",
+		kind: "read",
+		idempotent: true,
+		openWorld: false,
+		input: CourseIdPathParam,
+		call: ({ courseId }, { container, scope }) => container.reporting.admin.courseAnalytics(scope.orgId, courseId)
+	}),
+	defineTool({
+		name: "get_course_enrollment_trend",
+		title: "Get course enrollment trend",
+		description: "Daily enrollments in one course for the last days (default 30, at most 365).",
+		scope: "analytics:read",
+		kind: "read",
+		idempotent: true,
+		openWorld: false,
+		input: EnrollmentSeriesQuery.extend(CourseIdPathParam.shape),
+		call: ({ courseId, days }, { container, scope }) => container.reporting.admin.courseEnrollments(scope.orgId, courseId, days)
+	}),
+	defineTool({
+		name: "get_student_analytics",
+		title: "Get student analytics",
+		description: "One student's enrolled, started and completed counts, average progress and progress in each course.",
+		scope: "analytics:read",
+		kind: "read",
+		idempotent: true,
+		openWorld: false,
+		input: StudentIdParam,
+		call: ({ id }, { container, scope }) => container.reporting.admin.studentAnalytics(scope.orgId, id)
+	})
+];
+//#endregion
+export { peopleTools };
+
+//# sourceMappingURL=people.js.map

package/dist/http/mcp/tools/people.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"people.js","names":[],"sources":["../../../../src/http/mcp/tools/people.ts"],"sourcesContent":["import {\n  CourseIdPathParam,\n  CreateInvite,\n  EnrollmentSeriesQuery,\n  EntitlementIdParam,\n  EntitlementsQuery,\n  GrantEntitlement,\n  Invite,\n  SetEntitlementStatus,\n  StudentIdParam,\n  StudentsQuery,\n} from '../../schemas/index.js';\nimport { actor, defineTool, noInput, type Tool } from '../tool.js';\n\nexport const peopleTools: Tool[] = [\n  defineTool({\n    name: 'list_students',\n    title: 'List students',\n    description:\n      'Search and page through the students with their access count, average progress, status and last activity.',\n    scope: 'students:read',\n    kind: 'read',\n    idempotent: true,\n    openWorld: false,\n    input: StudentsQuery,\n    call: (input, { container, scope }) =>\n      container.reporting.admin.listStudents(scope.orgId, input),\n  }),\n  defineTool({\n    name: 'invite_student',\n    title: 'Invite student',\n    description:\n      'Invite someone by email as a student. They exist as an invited student at once. sendEmail false skips the email.',\n    scope: 'students:invite',\n    kind: 'write',\n    idempotent: false,\n    openWorld: true,\n    input: CreateInvite.omit({ role: true }),\n    output: Invite,\n    call: (input, { container, scope }) =>\n      container.organizations.createInvite(actor(scope), {\n        orgId: scope.orgId,\n        inviterUserId: scope.userId,\n        role: 'student',\n        ...input,\n      }),\n  }),\n  defineTool({\n    name: 'resend_student_invite',\n    title: 'Resend student invite',\n    description: \"Send a pending student's invite email again.\",\n    scope: 'students:invite',\n    kind: 'write',\n    idempotent: false,\n    openWorld: true,\n    input: StudentIdParam,\n    call: ({ id }, { container, scope }) =>\n      container.organizations.resendStudentInvite(actor(scope), {\n        orgId: scope.orgId,\n        orgUserId: id,\n        inviterUserId: scope.userId,\n      }),\n  }),\n  defineTool({\n    name: 'list_access',\n    title: 'List access',\n    description: 'Who has access to what. Filter by student (orgUserId), content, type or status.',\n    scope: 'access:read',\n    kind: 'read',\n    idempotent: true,\n    openWorld: false,\n    input: EntitlementsQuery,\n    call: (input, { container, scope }) => container.entitlements.list(scope.orgId, input),\n  }),\n  defineTool({\n    name: 'grant_access',\n    title: 'Grant access',\n    description:\n      'Give a student access to one course, download or community (contentId) or to a bundle (bundleId), never both. expiresAt is a date-time, or null for no expiry.',\n    scope: 'access:write',\n    kind: 'write',\n    idempotent: false,\n    openWorld: false,\n    input: GrantEntitlement,\n    call: (input, { container, scope }) => container.entitlements.grant(scope.orgId, input),\n  }),\n  defineTool({\n    name: 'set_access_status',\n    title: 'Revoke or reinstate access',\n    description: 'Revoke an access grant, or reinstate a revoked one.',\n    scope: 'access:write',\n    kind: 'destructive',\n    idempotent: true,\n    openWorld: false,\n    input: SetEntitlementStatus.extend(EntitlementIdParam.shape),\n    call: ({ id, status }, { container, scope }) =>\n      container.entitlements.setStatus(scope.orgId, id, status),\n  }),\n  defineTool({\n    name: 'get_dashboard',\n    title: 'Get dashboard',\n    description:\n      'Published and draft course counts, active students, and access grants expiring soon.',\n    scope: 'analytics:read',\n    kind: 'read',\n    idempotent: true,\n    openWorld: false,\n    input: noInput,\n    call: (_input, { container, scope }) => container.reporting.admin.overview(scope.orgId),\n  }),\n  defineTool({\n    name: 'get_enrollment_trend',\n    title: 'Get enrollment trend',\n    description:\n      'Daily enrollments across the organization for the last days (default 30, at most 365).',\n    scope: 'analytics:read',\n    kind: 'read',\n    idempotent: true,\n    openWorld: false,\n    input: EnrollmentSeriesQuery,\n    call: ({ days }, { container, scope }) =>\n      container.reporting.admin.enrollments(scope.orgId, days),\n  }),\n  defineTool({\n    name: 'get_course_analytics',\n    title: 'Get course analytics',\n    description:\n      'Enrolled, started and completed counts, average progress and per-activity engagement for one course.',\n    scope: 'analytics:read',\n    kind: 'read',\n    idempotent: true,\n    openWorld: false,\n    input: CourseIdPathParam,\n    call: ({ courseId }, { container, scope }) =>\n      container.reporting.admin.courseAnalytics(scope.orgId, courseId),\n  }),\n  defineTool({\n    name: 'get_course_enrollment_trend',\n    title: 'Get course enrollment trend',\n    description: 'Daily enrollments in one course for the last days (default 30, at most 365).',\n    scope: 'analytics:read',\n    kind: 'read',\n    idempotent: true,\n    openWorld: false,\n    input: EnrollmentSeriesQuery.extend(CourseIdPathParam.shape),\n    call: ({ courseId, days }, { container, scope }) =>\n      container.reporting.admin.courseEnrollments(scope.orgId, courseId, days),\n  }),\n  defineTool({\n    name: 'get_student_analytics',\n    title: 'Get student analytics',\n    description:\n      \"One student's enrolled, started and completed counts, average progress and progress in each course.\",\n    scope: 'analytics:read',\n    kind: 'read',\n    idempotent: true,\n    openWorld: false,\n    input: StudentIdParam,\n    call: ({ id }, { container, scope }) =>\n      container.reporting.admin.studentAnalytics(scope.orgId, id),\n  }),\n];\n"],"mappings":"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"}

package/dist/http/plugins/auth.js

@@ -2,18 +2,22 @@ import { bridgeWebResponse, toWebRequest } from "../web-bridge.js";
 //#region src/http/plugins/auth.ts
 /** The request carries no session. The central error handler maps this to 401. */
 var UnauthorizedError = class extends Error {
-	constructor(message = "no session on the request") {
+	constructor(message = "Sign in to continue") {
 		super(message);
 		this.name = "UnauthorizedError";
 	}
 };
 function registerAuth(app, appServer) {
 	const { auth } = appServer;
+	const origin = new URL(appServer.mcp.issuer).origin;
+	app.addContentTypeParser("application/x-www-form-urlencoded", { parseAs: "string" }, (_request, body, done) => {
+		done(null, body);
+	});
 	app.route({
 		method: ["GET", "POST"],
 		url: "/api/auth/*",
 		async handler(request, reply) {
-			await bridgeWebResponse(await auth.handler(toWebRequest(request)), reply);
+			await bridgeWebResponse(await auth.handler(toWebRequest(request, origin)), reply);
 		}
 	});
 	app.decorate("requireSession", async (request) => {
@@ -25,19 +29,23 @@ function registerAuth(app, appServer) {
 		if (authOrgId) {
 			request.authOrgId = authOrgId;
 			const org = await appServer.organizations.getByExternalId(authOrgId);
-			if (org) request.orgId = org.id;
+			if (org) {
+				request.orgId = org.id;
+				appServer.requestContext.set({ orgId: org.id });
+			}
 		}
 	});
 	app.decorate("requireOrgSession", async (request) => {
 		const session = await appServer.auth.verify(request.headers);
 		if (!session) throw new UnauthorizedError();
 		const authOrgId = session.session.activeOrganizationId;
-		if (!authOrgId) throw new UnauthorizedError();
+		if (!authOrgId) throw new UnauthorizedError("Choose an organization to continue");
 		const org = await appServer.organizations.getByExternalId(authOrgId);
-		if (!org) throw new UnauthorizedError("session organization not found");
+		if (!org) throw new UnauthorizedError("Your session points to an organization that no longer exists");
 		request.authUser = session.user;
 		request.userId = session.user.id;
 		request.orgId = org.id;
+		appServer.requestContext.set({ orgId: org.id });
 		request.authOrgId = authOrgId;
 	});
 }

package/dist/http/plugins/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","names":[],"sources":["../../../src/http/plugins/auth.ts"],"sourcesContent":["// Everything better-auth touches on the HTTP surface:\n//   - the /api/auth/* catch-all bridged to better-auth's Web handler\n//   - the `requireSession` / `requireOrgSession` decorators routes guard with\nimport type { FastifyInstance, FastifyRequest } from 'fastify';\nimport type { Container } from '../../app/container.js';\nimport { bridgeWebResponse, toWebRequest } from '../web-bridge.js';\n\n/** The request carries no session. The central error handler maps this to 401. */\nexport class UnauthorizedError extends Error {\n  constructor(message = 'no session on the request') {\n    super(message);\n    this.name = 'UnauthorizedError';\n  }\n}\n\nexport function registerAuth(app: FastifyInstance, appServer: Container): void {\n  const { auth } = appServer;\n\n  // Mount better-auth: a catch-all that bridges Fastify <-> Web Request/Response.\n  app.route({\n    method: ['GET', 'POST'],\n    url: '/api/auth/*',\n    async handler(request, reply) {\n      await bridgeWebResponse(await auth.handler(toWebRequest(request)), reply);\n    },\n  });\n\n  // Session only, no active org required. For the routes a caller reaches\n  // *before* they have an org: creating their first organization, and accepting\n  // an invitation (which is what stamps the active org onto the session).\n  app.decorate('requireSession', async (request: FastifyRequest) => {\n    const session = await appServer.auth.verify(request.headers);\n    if (!session) {\n      throw new UnauthorizedError();\n    }\n    request.authUser = session.user;\n    request.userId = session.user.id;\n\n    const authOrgId = session.session.activeOrganizationId;\n    if (authOrgId) {\n      request.authOrgId = authOrgId;\n      const org = await appServer.organizations.getByExternalId(authOrgId);\n      if (org) {\n        request.orgId = org.id;\n      }\n    }\n  });\n\n  // Requires a valid session with an active org set — every org-scoped route.\n  app.decorate('requireOrgSession', async (request: FastifyRequest) => {\n    const session = await appServer.auth.verify(request.headers);\n    if (!session) {\n      throw new UnauthorizedError();\n    }\n    const authOrgId = session.session.activeOrganizationId;\n    if (!authOrgId) {\n      throw new UnauthorizedError();\n    }\n\n    const org = await appServer.organizations.getByExternalId(authOrgId);\n    if (!org) {\n      throw new UnauthorizedError('session organization not found');\n    }\n    request.authUser = session.user;\n    request.userId = session.user.id;\n    request.orgId = org.id;\n    // resolveScope requires the auth-provider id too — routes that write back\n    // through better-auth key on it.\n    request.authOrgId = authOrgId;\n  });\n}\n"],"mappings":";;;AAQA,IAAa,oBAAb,cAAuC,MAAM;CAC3C,YAAY,UAAU,6BAA6B;EACjD,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF;AAEA,SAAgB,aAAa,KAAsB,WAA4B;CAC7E,MAAM,EAAE,SAAS;CAGjB,IAAI,MAAM;EACR,QAAQ,CAAC,OAAO,MAAM;EACtB,KAAK;EACL,MAAM,QAAQ,SAAS,OAAO;GAC5B,MAAM,kBAAkB,MAAM,KAAK,QAAQ,aAAa,OAAO,CAAC,GAAG,KAAK;EAC1E;CACF,CAAC;CAKD,IAAI,SAAS,kBAAkB,OAAO,YAA4B;EAChE,MAAM,UAAU,MAAM,UAAU,KAAK,OAAO,QAAQ,OAAO;EAC3D,IAAI,CAAC,SACH,MAAM,IAAI,kBAAkB;EAE9B,QAAQ,WAAW,QAAQ;EAC3B,QAAQ,SAAS,QAAQ,KAAK;EAE9B,MAAM,YAAY,QAAQ,QAAQ;EAClC,IAAI,WAAW;GACb,QAAQ,YAAY;GACpB,MAAM,MAAM,MAAM,UAAU,cAAc,gBAAgB,SAAS;GACnE,IAAI,KACF,QAAQ,QAAQ,IAAI;EAExB;CACF,CAAC;CAGD,IAAI,SAAS,qBAAqB,OAAO,YAA4B;EACnE,MAAM,UAAU,MAAM,UAAU,KAAK,OAAO,QAAQ,OAAO;EAC3D,IAAI,CAAC,SACH,MAAM,IAAI,kBAAkB;EAE9B,MAAM,YAAY,QAAQ,QAAQ;EAClC,IAAI,CAAC,WACH,MAAM,IAAI,kBAAkB;EAG9B,MAAM,MAAM,MAAM,UAAU,cAAc,gBAAgB,SAAS;EACnE,IAAI,CAAC,KACH,MAAM,IAAI,kBAAkB,gCAAgC;EAE9D,QAAQ,WAAW,QAAQ;EAC3B,QAAQ,SAAS,QAAQ,KAAK;EAC9B,QAAQ,QAAQ,IAAI;EAGpB,QAAQ,YAAY;CACtB,CAAC;AACH"}
+{"version":3,"file":"auth.js","names":[],"sources":["../../../src/http/plugins/auth.ts"],"sourcesContent":["// Everything better-auth touches on the HTTP surface:\n//   - the /api/auth/* catch-all bridged to better-auth's Web handler\n//   - the `requireSession` / `requireOrgSession` decorators routes guard with\nimport type { FastifyInstance, FastifyRequest } from 'fastify';\nimport type { Container } from '../../app/container.js';\nimport { bridgeWebResponse, toWebRequest } from '../web-bridge.js';\n\n/** The request carries no session. The central error handler maps this to 401. */\nexport class UnauthorizedError extends Error {\n  constructor(message = 'Sign in to continue') {\n    super(message);\n    this.name = 'UnauthorizedError';\n  }\n}\n\nexport function registerAuth(app: FastifyInstance, appServer: Container): void {\n  const { auth } = appServer;\n  const origin = new URL(appServer.mcp.issuer).origin;\n\n  app.addContentTypeParser(\n    'application/x-www-form-urlencoded',\n    { parseAs: 'string' },\n    (_request, body, done) => {\n      done(null, body);\n    },\n  );\n\n  // Mount better-auth: a catch-all that bridges Fastify <-> Web Request/Response.\n  app.route({\n    method: ['GET', 'POST'],\n    url: '/api/auth/*',\n    async handler(request, reply) {\n      await bridgeWebResponse(await auth.handler(toWebRequest(request, origin)), reply);\n    },\n  });\n\n  // Session only, no active org required. For the routes a caller reaches\n  // *before* they have an org: creating their first organization, and accepting\n  // an invitation (which is what stamps the active org onto the session).\n  app.decorate('requireSession', async (request: FastifyRequest) => {\n    const session = await appServer.auth.verify(request.headers);\n    if (!session) {\n      throw new UnauthorizedError();\n    }\n    request.authUser = session.user;\n    request.userId = session.user.id;\n\n    const authOrgId = session.session.activeOrganizationId;\n    if (authOrgId) {\n      request.authOrgId = authOrgId;\n      const org = await appServer.organizations.getByExternalId(authOrgId);\n      if (org) {\n        request.orgId = org.id;\n        appServer.requestContext.set({ orgId: org.id });\n      }\n    }\n  });\n\n  // Requires a valid session with an active org set — every org-scoped route.\n  app.decorate('requireOrgSession', async (request: FastifyRequest) => {\n    const session = await appServer.auth.verify(request.headers);\n    if (!session) {\n      throw new UnauthorizedError();\n    }\n    const authOrgId = session.session.activeOrganizationId;\n    if (!authOrgId) {\n      throw new UnauthorizedError('Choose an organization to continue');\n    }\n\n    const org = await appServer.organizations.getByExternalId(authOrgId);\n    if (!org) {\n      throw new UnauthorizedError('Your session points to an organization that no longer exists');\n    }\n    request.authUser = session.user;\n    request.userId = session.user.id;\n    request.orgId = org.id;\n    appServer.requestContext.set({ orgId: org.id });\n    // resolveScope requires the auth-provider id too — routes that write back\n    // through better-auth key on it.\n    request.authOrgId = authOrgId;\n  });\n}\n"],"mappings":";;;AAQA,IAAa,oBAAb,cAAuC,MAAM;CAC3C,YAAY,UAAU,uBAAuB;EAC3C,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF;AAEA,SAAgB,aAAa,KAAsB,WAA4B;CAC7E,MAAM,EAAE,SAAS;CACjB,MAAM,SAAS,IAAI,IAAI,UAAU,IAAI,MAAM,CAAC,CAAC;CAE7C,IAAI,qBACF,qCACA,EAAE,SAAS,SAAS,IACnB,UAAU,MAAM,SAAS;EACxB,KAAK,MAAM,IAAI;CACjB,CACF;CAGA,IAAI,MAAM;EACR,QAAQ,CAAC,OAAO,MAAM;EACtB,KAAK;EACL,MAAM,QAAQ,SAAS,OAAO;GAC5B,MAAM,kBAAkB,MAAM,KAAK,QAAQ,aAAa,SAAS,MAAM,CAAC,GAAG,KAAK;EAClF;CACF,CAAC;CAKD,IAAI,SAAS,kBAAkB,OAAO,YAA4B;EAChE,MAAM,UAAU,MAAM,UAAU,KAAK,OAAO,QAAQ,OAAO;EAC3D,IAAI,CAAC,SACH,MAAM,IAAI,kBAAkB;EAE9B,QAAQ,WAAW,QAAQ;EAC3B,QAAQ,SAAS,QAAQ,KAAK;EAE9B,MAAM,YAAY,QAAQ,QAAQ;EAClC,IAAI,WAAW;GACb,QAAQ,YAAY;GACpB,MAAM,MAAM,MAAM,UAAU,cAAc,gBAAgB,SAAS;GACnE,IAAI,KAAK;IACP,QAAQ,QAAQ,IAAI;IACpB,UAAU,eAAe,IAAI,EAAE,OAAO,IAAI,GAAG,CAAC;GAChD;EACF;CACF,CAAC;CAGD,IAAI,SAAS,qBAAqB,OAAO,YAA4B;EACnE,MAAM,UAAU,MAAM,UAAU,KAAK,OAAO,QAAQ,OAAO;EAC3D,IAAI,CAAC,SACH,MAAM,IAAI,kBAAkB;EAE9B,MAAM,YAAY,QAAQ,QAAQ;EAClC,IAAI,CAAC,WACH,MAAM,IAAI,kBAAkB,oCAAoC;EAGlE,MAAM,MAAM,MAAM,UAAU,cAAc,gBAAgB,SAAS;EACnE,IAAI,CAAC,KACH,MAAM,IAAI,kBAAkB,8DAA8D;EAE5F,QAAQ,WAAW,QAAQ;EAC3B,QAAQ,SAAS,QAAQ,KAAK;EAC9B,QAAQ,QAAQ,IAAI;EACpB,UAAU,eAAe,IAAI,EAAE,OAAO,IAAI,GAAG,CAAC;EAG9C,QAAQ,YAAY;CACtB,CAAC;AACH"}

package/dist/http/plugins/error-handler.d.ts

@@ -1,6 +1,7 @@
 import { FastifyReply, FastifyRequest } from "fastify";
 //#region src/http/plugins/error-handler.d.ts
 declare function errorHandler(error: unknown, request: FastifyRequest, reply: FastifyReply): FastifyReply<import("fastify").RouteGenericInterface, import("fastify").RawServerDefault, import("http").IncomingMessage, import("http").ServerResponse<import("http").IncomingMessage>, unknown, import("fastify").FastifySchema, import("fastify").FastifyTypeProviderDefault, unknown>;
+declare function notFoundHandler(request: FastifyRequest, reply: FastifyReply): FastifyReply<import("fastify").RouteGenericInterface, import("fastify").RawServerDefault, import("http").IncomingMessage, import("http").ServerResponse<import("http").IncomingMessage>, unknown, import("fastify").FastifySchema, import("fastify").FastifyTypeProviderDefault, unknown>;
 //#endregion
-export { errorHandler };
+export { errorHandler, notFoundHandler };
 //# sourceMappingURL=error-handler.d.ts.map