@taskforcehq/taskforce 0.3.305 → 0.3.306

package/dist/mcp/runtime.d.ts

@@ -2,6 +2,7 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { McpAccessTokenScope, TaskforceCore } from '../core/Taskforce.js';
 import { type AiProfileBootstrapConfig } from './aiProfileBootstrap.js';
+import { type AiProfileSeatScope } from '../shared/aiProfileSeatScope.js';
 export interface TaskforceMcpServerOptions {
     projectRoot?: string;
     tenantId?: string;
@@ -23,6 +24,7 @@ export interface TaskforceMcpServerOptions {
         aiProfileProvider?: AiProfileBootstrapConfig['aiProfileProvider'];
         aiProfileModel?: AiProfileBootstrapConfig['aiProfileModel'];
         aiProfileSurfaceType?: AiProfileBootstrapConfig['aiProfileSurfaceType'];
+        aiProfileSeatScope?: AiProfileSeatScope | null;
         actorType?: 'local' | 'user' | 'token' | 'oauth';
         requestId?: string | null;
         ip?: string | null;

package/dist/mcp/runtime.js

@@ -23,6 +23,7 @@ import { getImageReferenceLabel, parseImageReference } from '../utils/imageRefer
 import { inferCanonicalAssetKind, isValidCanonicalDocumentAsset } from '../utils/canonicalAssetKind.js';
 import { getTaskReferenceLabel, shouldUseProvisionalTaskReferences } from '../utils/taskReferences.js';
 import { parseAiProfileSurfaceType } from '../shared/aiProfileSurfaceType.js';
+import { parseAiProfileSeatScope } from '../shared/aiProfileSeatScope.js';
 import { formatWorkstreamReference, resolveInitiativeReference, parseWorkstreamReference, } from '../utils/planningReferences.js';
 import { MCP_TOOL_PERMISSIONS, MCP_WRITE_TOOL_NAMES } from './toolRegistry.js';
 import { registerAdminWorkspaceTools } from './adminWorkspaceRegistrar.js';
@@ -102,6 +103,13 @@ function resolveRecoverableToolError(error) {
                 message,
                 code,
                 ...(details !== undefined ? { details } : {}),
+                ...(code === 'AI_PROFILE_RETIRED'
+                    ? {
+                        nextTool: 'resolve_profile',
+                        suggestedArgs: {},
+                        retryHint: 'Call resolve_profile to intentionally reactivate the retired AI identity, then retry the original mutating tool call.'
+                    }
+                    : {}),
                 ...(code === 'TAXONOMY_NEEDS_CONFIRMATION' ? { needs_confirmation: true } : {})
             };
         }
@@ -227,6 +235,7 @@ export function createTaskforceMcpServer(options = {}) {
     const allowedScopes = Array.isArray(options.auth?.scopes)
         ? Array.from(new Set(options.auth.scopes))
         : null;
+    const configuredAiProfileSeatScope = runtimeMode === 'cloud' ? 'cloud_metered' : 'local_unmetered';
     if (logStartup) {
         console.error(`[Taskforce MCP] Starting for project: ${PROJECT_NAME} at ${PROJECT_ROOT}`);
     }
@@ -333,7 +342,7 @@ export function createTaskforceMcpServer(options = {}) {
             },
             tools: {},
         },
-        instructions: `You are an AI collaborator connected to Taskforce, a shared task management system for AI-developer pairs.\n\nIMPORTANT: Before mutating Taskforce data, ensure Taskforce knows which AI profile you are acting as. The preferred path is ambient session binding: if your MCP connection is configured with x-taskforce-ai-name and optionally x-taskforce-ai-profile-token headers, Taskforce can auto-bind that AI identity for get_current_profile and later writes. If no AI identity is currently bound, call resolve_profile with your name. Reuse the returned profileToken across sessions, especially for stateless clients.\n\nStateless client pattern: call resolve_profile, save the returned profileToken, and include profileToken on later mutating tool calls only when your MCP client does not preserve session identity between calls.\n\nTo inspect your current attribution state before writes, call get_current_profile. It reports whether identity is bound, how it was resolved, and the suggested args to use with list_tasks.\n\nWhen setting resolve_profile.surfaceType, classify yourself by the kind of identity you are registering: use agent for a persistent named AI collaborator in Taskforce, coding_tool for the coding surface or terminal tool itself, chat_app for a conversational app identity, ide for an IDE-native copilot identity, and other only when none of those fit. If you are unsure and you are registering a named collaborator such as a teammate-style AI persona, choose agent.\n\nTo get tasks assigned to yourself, call get_current_profile, then use the returned suggestedArgs with list_tasks. When you begin active work on a tracked task, prefer start_task. It sets the task to in-progress and claims it for your AI profile when the task is currently unassigned. When work on a tracked task is complete, prefer finish_task for the final handoff: use outcome='review' when the next step is human validation or approval, and use outcome='done' only when no explicit human action is requested. Do not leave a task in-progress after reporting completed implementation unless the user explicitly wants more work to continue in the same task.\n\nTaxonomy rule: always call get_config before setting category, type, priority, approach, status, or complexity. Do not rely on remembered enum values.\n\nUse identifier prefixes to choose the correct retrieval path: T-123 goes to task tools such as get_task, IN-123 goes to initiative tools such as get_initiative, WS-123 goes to workstream tools such as get_workstream, I-123 goes to image tools such as get_image, and D-123 goes to document tools such as get_document. Do not send I-123 or D-123 identifiers to get_task.\n\nFor annotated images, use search_images first when you know only a keyword, filename, or rough title. Once you have the exact identifier, call get_image, then use get_annotated_attachment_sessions to list saved sessions, then use read_annotated_attachment_payload for the structured annotation payload.\n\nFor documents, use search_documents first when you know only a keyword, filename, or rough title. Once you have the exact identifier, call get_document, then read_document_content to inspect the document body. For a lower-friction review flow, prefer review_document; otherwise use get_document_review_sessions or create_document_review_session, then add_document_review_comment to record review feedback.`,
+        instructions: `You are an AI collaborator connected to Taskforce, a shared task management system for AI-developer pairs.\n\nIMPORTANT: Before mutating Taskforce data, ensure Taskforce knows which AI profile you are acting as. The preferred path is ambient session binding: if your MCP connection is configured with x-taskforce-ai-name and optionally x-taskforce-ai-profile-token headers, Taskforce can auto-bind that AI identity for get_current_profile and later writes. If no AI identity is currently bound, call resolve_profile with your name. Reuse the returned profileToken across sessions, especially for stateless clients.\n\nStateless client pattern: call resolve_profile, save the returned profileToken, and include profileToken on later mutating tool calls only when your MCP client does not preserve session identity between calls.\n\nTo inspect your current attribution state before writes, call get_current_profile. It reports whether identity is bound, how it was resolved, and the suggested args to use with list_tasks.\n\nWhen setting resolve_profile.surfaceType, classify yourself by the kind of identity you are registering: use agent for a persistent named AI collaborator in Taskforce, coding_tool for the coding surface or terminal tool itself, chat_app for a conversational app identity, ide for an IDE-native copilot identity, and other only when none of those fit. If you are unsure and you are registering a named collaborator such as a teammate-style AI persona, choose agent.\n\nTo get tasks assigned to yourself, call get_current_profile, then use the returned suggestedArgs with list_tasks. When you begin active work on a tracked task, prefer start_task. It sets the task to in-progress and claims it for your AI profile when the task is currently unassigned. When work on a tracked task is complete, prefer finish_task for the final handoff: use outcome='review' when the next step is human validation or approval, and use outcome='done' only when no explicit human action is requested. Do not leave a task in-progress after reporting completed implementation unless the user explicitly wants more work to continue in the same task.\n\nTaxonomy rule: always call get_config before setting category, type, priority, approach, status, or complexity. Do not rely on remembered enum values.\n\nUse identifier prefixes to choose the correct retrieval path: T-123 goes to task tools such as get_task, IN-123 goes to initiative tools such as get_initiative, WS-123 goes to workstream tools such as get_workstream, I-123 goes to image tools such as get_image, and D-123 goes to document tools such as get_document. Do not send I-123 or D-123 identifiers to get_task.\n\nFor annotated images, use search_images first when you know only a keyword, filename, or rough title. Once you have the exact identifier, call get_image, then use get_annotated_attachment_sessions to list saved sessions, then use read_annotated_attachment_payload for the structured annotation payload. If an image reference is being used for UI, placement, or visual correction feedback, treat the saved annotation payload as the source of truth and do not infer intent from the screenshot alone.\n\nFor documents, use search_documents first when you know only a keyword, filename, or rough title. Once you have the exact identifier, call get_document, then read_document_content to inspect the document body. For a lower-friction review flow, prefer review_document; otherwise use get_document_review_sessions or create_document_review_session, then add_document_review_comment to record review feedback.`,
     });
     const TOOL_PERMISSIONS = MCP_TOOL_PERMISSIONS;
     const RESOURCE_PERMISSIONS = {
@@ -562,6 +571,7 @@ export function createTaskforceMcpServer(options = {}) {
                 provider: typeof actor.meta?.provider === 'string' ? actor.meta.provider : null,
                 model: typeof actor.meta?.model === 'string' ? actor.meta.model : null,
                 surfaceType: typeof actor.meta?.surfaceType === 'string' ? actor.meta.surfaceType : null,
+                seatScope: parseAiProfileSeatScope(actor.meta?.seatScope),
             } : {}),
             ...(activeAiProfileId && actor.id === activeAiProfileId ? { isCurrentProfile: true } : {})
         }))
@@ -581,6 +591,7 @@ export function createTaskforceMcpServer(options = {}) {
             provider: profile.provider ?? null,
             model: profile.model ?? null,
             surfaceType: profile.surfaceType ?? null,
+            seatScope: profile.seatScope ?? null,
             lastActiveAt: profile.lastActiveAt ?? null,
         };
     }
@@ -692,7 +703,7 @@ export function createTaskforceMcpServer(options = {}) {
     }
     function buildConfiguredAiProfileResolveInput(includeToken = true) {
         const configuredSurfaceType = parseAiProfileSurfaceType(configuredAiProfileSurfaceType);
-        return buildResolveAiProfileInputFromBootstrap(ACTIVE_WORKSPACE_ID, {
+        const baseInput = buildResolveAiProfileInputFromBootstrap(ACTIVE_WORKSPACE_ID, {
             aiProfileToken: configuredAiProfileToken,
             aiProfileName: configuredAiProfileName,
             aiProfileIcon: configuredAiProfileIcon,
@@ -703,6 +714,51 @@ export function createTaskforceMcpServer(options = {}) {
             aiProfileModel: configuredAiProfileModel,
             aiProfileSurfaceType: configuredSurfaceType,
         }, includeToken);
+        if (!baseInput)
+            return null;
+        return baseInput;
+    }
+    function normalizeConfiguredAiProfileUsername(value, fallbackName) {
+        const source = String(value || fallbackName || '').trim().toLowerCase();
+        const normalized = source
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/-+/g, '-')
+            .replace(/^-+|-+$/g, '')
+            .slice(0, 48);
+        return normalized || 'ai';
+    }
+    function findArchivedConfiguredAiProfileCandidate() {
+        if (configuredAiProfileToken) {
+            const profile = core.getAiProfileByToken({
+                workspaceId: ACTIVE_WORKSPACE_ID,
+                profileToken: configuredAiProfileToken,
+                includeArchived: true,
+                seatScope: configuredAiProfileSeatScope,
+            });
+            if (profile?.archivedAt)
+                return profile;
+        }
+        const configuredName = String(configuredAiProfileName || '').trim();
+        if (!configuredName)
+            return null;
+        const normalizedUsername = normalizeConfiguredAiProfileUsername(undefined, configuredName).toLowerCase();
+        return core.listAiProfiles(ACTIVE_WORKSPACE_ID, { includeArchived: true }).find((profile) => {
+            if (!profile.archivedAt)
+                return false;
+            if ((profile.seatScope ?? null) !== configuredAiProfileSeatScope)
+                return false;
+            const profileName = String(profile.name || '').trim().toLowerCase();
+            const profileUsername = String(profile.username || '').trim().toLowerCase();
+            return profileName === configuredName.toLowerCase() || profileUsername === normalizedUsername;
+        }) || null;
+    }
+    function throwArchivedConfiguredAiProfileError(profile) {
+        throw new TaskforceRuleError(`AI profile "${profile.name}" has been retired from this workspace. Call resolve_profile to reactivate it before retrying.`, 409, 'AI_PROFILE_RETIRED', {
+            workspaceId: ACTIVE_WORKSPACE_ID,
+            profileId: profile.id,
+            profileToken: profile.profileToken || null,
+            archivedReason: profile.archivedReason || null,
+        });
     }
     function ensureResolvedProfileFromConnection(defaults) {
         if (activeAiProfileId)
@@ -710,10 +766,16 @@ export function createTaskforceMcpServer(options = {}) {
         const allowCreateFromName = defaults?.allowCreateFromName === true;
         const configuredResolveInput = buildConfiguredAiProfileResolveInput(true);
         const configuredResolveFallbackInput = buildConfiguredAiProfileResolveInput(false);
+        const archivedConfiguredProfile = findArchivedConfiguredAiProfileCandidate();
+        if (archivedConfiguredProfile) {
+            throwArchivedConfiguredAiProfileError(archivedConfiguredProfile);
+        }
         if (configuredAiProfileToken) {
             if (configuredResolveInput) {
                 try {
-                    const resolved = core.resolveAiProfile(configuredResolveInput);
+                    const resolved = core.resolveAiProfile(configuredResolveInput, {
+                        trustedSeatScope: configuredAiProfileSeatScope,
+                    });
                     activeAiProfileId = resolved.profile.id;
                     activeAiBindingSource = 'connection_bootstrap';
                     return;
@@ -725,6 +787,7 @@ export function createTaskforceMcpServer(options = {}) {
             const profile = core.getAiProfileByToken({
                 workspaceId: ACTIVE_WORKSPACE_ID,
                 profileToken: configuredAiProfileToken,
+                seatScope: configuredAiProfileSeatScope,
             });
             if (profile) {
                 activeAiProfileId = profile.id;
@@ -736,7 +799,9 @@ export function createTaskforceMcpServer(options = {}) {
             }
         }
         if (allowCreateFromName && configuredResolveFallbackInput) {
-            const resolved = core.resolveAiProfile(configuredResolveFallbackInput);
+            const resolved = core.resolveAiProfile(configuredResolveFallbackInput, {
+                trustedSeatScope: configuredAiProfileSeatScope,
+            });
             activeAiProfileId = resolved.profile.id;
             activeAiBindingSource = 'connection_bootstrap';
         }
@@ -756,6 +821,7 @@ export function createTaskforceMcpServer(options = {}) {
         const profile = core.getAiProfileByToken({
             workspaceId: ACTIVE_WORKSPACE_ID,
             profileToken,
+            seatScope: configuredAiProfileSeatScope,
         });
         if (profile) {
             activeAiProfileId = profile.id;
@@ -764,7 +830,9 @@ export function createTaskforceMcpServer(options = {}) {
         }
         const configuredResolveInput = buildConfiguredAiProfileResolveInput(false);
         if (configuredResolveInput) {
-            const resolved = core.resolveAiProfile(configuredResolveInput);
+            const resolved = core.resolveAiProfile(configuredResolveInput, {
+                trustedSeatScope: configuredAiProfileSeatScope,
+            });
             activeAiProfileId = resolved.profile.id;
             activeAiBindingSource = 'connection_bootstrap';
             return;
@@ -1224,6 +1292,21 @@ export function createTaskforceMcpServer(options = {}) {
         const d = String(date.getDate()).padStart(2, '0');
         return `${y}-${m}-${d}`;
     }
+    function dateOnlyToIsoWeekKey(dateOnly) {
+        const parsed = parseDateOnlyLocal(dateOnly);
+        if (!parsed)
+            return null;
+        const weekDate = new Date(Date.UTC(parsed.getFullYear(), parsed.getMonth(), parsed.getDate()));
+        const day = weekDate.getUTCDay() || 7;
+        weekDate.setUTCDate(weekDate.getUTCDate() + 4 - day);
+        const year = weekDate.getUTCFullYear();
+        const yearStart = new Date(Date.UTC(year, 0, 1));
+        const week = Math.ceil((((weekDate.getTime() - yearStart.getTime()) / 86400000) + 1) / 7);
+        return `${year}-W${String(week).padStart(2, '0')}`;
+    }
+    function currentIsoWeekKeyLocal() {
+        return dateOnlyToIsoWeekKey(formatDateOnlyLocal(new Date())) || '';
+    }
     function addDaysDateOnly(dateOnly, days) {
         const parsed = parseDateOnlyLocal(dateOnly);
         if (!parsed)
@@ -1817,53 +1900,20 @@ export function createTaskforceMcpServer(options = {}) {
             case "list_tasks": {
                 const startedAtMs = Date.now();
                 const { format = "markdown", category, status, openOnly = false, assignee, priority, type, sort = "created", order = "desc", limit } = args;
-                let data = core.listTasks(ACTIVE_WORKSPACE_ID);
-                let tasks = data.tasks;
-                const openStatuses = new Set(["task", "on-hold", "in-progress", "review"]);
-                // Filtering
-                if (category)
-                    tasks = tasks.filter(t => t.category === category);
-                if (status)
-                    tasks = tasks.filter(t => t.status === status);
-                if (openOnly)
-                    tasks = tasks.filter(t => openStatuses.has(t.status));
-                if (assignee)
-                    tasks = tasks.filter(t => (t.assignee || 'unassigned') === assignee);
-                if (priority !== undefined)
-                    tasks = tasks.filter(t => t.priority === Number(priority));
-                if (type)
-                    tasks = tasks.filter(t => t.type === type);
-                // Sorting
-                tasks.sort((a, b) => {
-                    let aVal, bVal;
-                    if (sort === "priority") {
-                        aVal = a.priority;
-                        bVal = b.priority;
-                    }
-                    else if (sort === "updated") {
-                        aVal = a.updatedAt || a.createdAt;
-                        bVal = b.updatedAt || b.createdAt;
-                    }
-                    else {
-                        aVal = a.createdAt;
-                        bVal = b.createdAt;
-                    }
-                    const cmp = aVal < bVal ? -1 : aVal > bVal ? 1 : 0;
-                    return order === "asc" ? cmp : -cmp;
+                const slimTasks = core.listTasksSlim(ACTIVE_WORKSPACE_ID, {
+                    category,
+                    status,
+                    openOnly: Boolean(openOnly),
+                    assignee,
+                    priority: priority !== undefined ? Number(priority) : undefined,
+                    type,
+                    sort,
+                    order,
+                    limit: typeof limit === 'number' ? limit : (limit ? Number(limit) : undefined),
                 });
-                // Limiting
-                if (limit && limit > 0) {
-                    tasks = tasks.slice(0, limit);
-                }
-                // Strip verbose detail fields — descriptions, comments, events, and derived
-                // activity are omitted from list responses to keep context window usage
-                // manageable. Use get_task to retrieve full details for a specific task.
-                const slimTasks = tasks.map(({ description, comments, taskEvents, activity, createdByActor, assigneeActor, attachments, checklistItems, ...rest }) => rest);
                 logMcpReadObservation('list_tasks', startedAtMs, {
                     format,
-                    totalTasks: data.tasks.length,
                     returnedTasks: slimTasks.length,
-                    filtered: slimTasks.length !== data.tasks.length,
                     openOnly,
                     hasAssigneeFilter: Boolean(assignee),
                     hasStatusFilter: Boolean(status),
@@ -1895,6 +1945,8 @@ export function createTaskforceMcpServer(options = {}) {
                     model,
                     surfaceType: typeof surfaceType === 'string' || surfaceType === null ? surfaceType : undefined,
                     profileToken: typeof profileToken === 'string' ? profileToken : null
+                }, {
+                    trustedSeatScope: configuredAiProfileSeatScope,
                 });
                 activeAiProfileId = resolved.profile.id;
                 activeAiBindingSource = 'session';
@@ -1921,6 +1973,7 @@ export function createTaskforceMcpServer(options = {}) {
                                     provider: resolved.profile.provider ?? null,
                                     model: resolved.profile.model ?? null,
                                     surfaceType: resolved.profile.surfaceType ?? null,
+                                    seatScope: resolved.profile.seatScope ?? null,
                                     lastActiveAt: resolved.profile.lastActiveAt
                                 },
                                 ...(resolved.duplicateWarning && { duplicateWarning: resolved.duplicateWarning })
@@ -1951,6 +2004,7 @@ export function createTaskforceMcpServer(options = {}) {
                     profile = core.getAiProfileByToken({
                         workspaceId: ACTIVE_WORKSPACE_ID,
                         profileToken: profileToken.trim(),
+                        seatScope: configuredAiProfileSeatScope,
                     });
                     if (!profile) {
                         throw new Error('Invalid AI profile token. Call resolve_profile again and retry.');
@@ -2430,19 +2484,21 @@ export function createTaskforceMcpServer(options = {}) {
                 }
                 const linkedTasks = (workspaceAssetStore?.listLinksForAsset(image.assetId, ACTIVE_WORKSPACE_ID) || [])
                     .filter((entry) => !entry.deletedAt)
+                    .filter((entry) => entry.targetType === 'task' && !!entry.taskId)
                     .reduce((entries, link) => {
-                    if (entries.some((entry) => entry.taskId === link.taskId))
+                    const taskId = link.taskId;
+                    if (entries.some((entry) => entry.taskId === taskId))
                         return entries;
-                    const task = core.resolveTaskIdentifier(link.taskId, ACTIVE_WORKSPACE_ID);
+                    const task = core.resolveTaskIdentifier(taskId, ACTIVE_WORKSPACE_ID);
                     const taskReferenceLabel = task?.referenceLabel || (task ? getTaskReferenceLabel(task) : null);
-                    const sessions = (linkedTaskSessions.get(link.taskId) || []).map((session) => ({
+                    const sessions = (linkedTaskSessions.get(taskId) || []).map((session) => ({
                         id: session.id,
                         title: session.title,
                         updatedAt: session.updatedAt,
                         annotationCount: Array.isArray(session.annotations) ? session.annotations.length : 0,
                     }));
                     entries.push({
-                        taskId: link.taskId,
+                        taskId,
                         referenceLabel: taskReferenceLabel,
                         role: link.role,
                         caption: link.displayName || null,
@@ -2492,11 +2548,13 @@ export function createTaskforceMcpServer(options = {}) {
                 const asset = resolveDocumentAssetByIdentifierOrThrow(documentId);
                 const linkedTasks = (workspaceAssetStore?.listLinksForAsset(asset.assetId, ACTIVE_WORKSPACE_ID) || [])
                     .filter((entry) => !entry.deletedAt)
+                    .filter((entry) => entry.targetType === 'task' && !!entry.taskId)
                     .map((link) => {
-                    const task = core.resolveTaskIdentifier(link.taskId, ACTIVE_WORKSPACE_ID);
+                    const taskId = link.taskId;
+                    const task = core.resolveTaskIdentifier(taskId, ACTIVE_WORKSPACE_ID);
                     const taskReferenceLabel = task?.referenceLabel || (task ? getTaskReferenceLabel(task) : null);
                     return {
-                        taskId: link.taskId,
+                        taskId,
                         referenceLabel: taskReferenceLabel,
                         role: link.role,
                         caption: link.displayName || null,
@@ -3188,16 +3246,19 @@ export function createTaskforceMcpServer(options = {}) {
             }
             case "get_schedule_board": {
                 const { week, showWeekends = false } = args;
-                if (!week || typeof week !== 'string') {
-                    throw new Error('week is required');
-                }
-                const board = core.getScheduleBoard(week, Boolean(showWeekends), ACTIVE_WORKSPACE_ID);
+                const weekKey = typeof week === 'string' && week.trim()
+                    ? week.trim()
+                    : currentIsoWeekKeyLocal();
+                const board = core.getScheduleBoard(weekKey, Boolean(showWeekends), ACTIVE_WORKSPACE_ID);
                 return {
                     content: [{ type: "text", text: JSON.stringify(board, null, 2) }],
                 };
             }
             case "schedule_task": {
-                const { id: inputId, scheduledDate, orderInDay } = args;
+                const { id: legacyInputId, taskId, scheduledDate: legacyScheduledDate, date, orderInDay: legacyOrderInDay, order } = args;
+                const inputId = taskId ?? legacyInputId;
+                const scheduledDate = date ?? legacyScheduledDate;
+                const orderInDay = order ?? legacyOrderInDay;
                 const { id } = resolveTaskByIdentifierOrThrow(inputId);
                 if (!scheduledDate || typeof scheduledDate !== 'string')
                     throw new Error('scheduledDate is required');
@@ -3230,7 +3291,8 @@ export function createTaskforceMcpServer(options = {}) {
                 };
             }
             case "unschedule_task": {
-                const { id: inputId } = args;
+                const { id: legacyInputId, taskId } = args;
+                const inputId = taskId ?? legacyInputId;
                 const { id } = resolveTaskByIdentifierOrThrow(inputId);
                 const result = core.updateTaskSchedule(id, { scheduledDate: null, orderInDay: null }, ACTIVE_WORKSPACE_ID);
                 if (!result) {
@@ -3261,13 +3323,18 @@ export function createTaskforceMcpServer(options = {}) {
                 };
             }
             case "reorder_scheduled_tasks": {
-                const { moves } = args;
-                if (!Array.isArray(moves)) {
+                const { moves, date, taskIds } = args;
+                const inputMoves = Array.isArray(moves)
+                    ? moves
+                    : Array.isArray(taskIds) && typeof date === 'string'
+                        ? taskIds.map((taskId, index) => ({ id: taskId, scheduledDate: date, orderInDay: index }))
+                        : null;
+                if (!Array.isArray(inputMoves)) {
                     throw new Error('moves must be an array');
                 }
-                const resolvedMoves = moves.map((move) => ({
+                const resolvedMoves = inputMoves.map((move) => ({
                     ...move,
-                    id: resolveTaskByIdentifierOrThrow(move?.id).id
+                    id: resolveTaskByIdentifierOrThrow(move?.taskId ?? move?.id).id
                 }));
                 const result = core.reorderScheduledTasks(resolvedMoves, ACTIVE_WORKSPACE_ID);
                 recordMcpWriteAudit('reorder_scheduled_tasks', {