/**
* Create Project Template Tool
* Create a new task template in a project
*/
import { z } from 'zod';
import * as projectsApi from '../../api/projects.js';
import { formatError } from '../../utils/errors.js';
const memberAssignmentSchema = z.object({
type: z.enum(['member', 'emailUser']),
organizationMemberId: z.string().optional().describe('Organization member ID (for type: member)'),
emailAddress: z.string().optional().describe('Email address (for type: emailUser)'),
name: z.string().optional().describe('Name (for type: emailUser)'),
});
const bodySchema = z.object({
mimeType: z.enum(['text/x-markdown', 'text/html']),
content: z.string(),
});
export const createProjectTemplateSchema = z.object({
projectId: z.string().describe('Project ID where the template will be created'),
templateName: z.string().describe('Template name (required)'),
users: z.object({
to: z.array(memberAssignmentSchema).optional().describe('Default assignees'),
cc: z.array(memberAssignmentSchema).optional().describe('Default CC recipients'),
}).optional().describe('Default users for tasks created from this template'),
body: bodySchema.optional().describe('Default task body content'),
guide: bodySchema.optional().describe('Guide content shown to users when writing tasks'),
subject: z.string().optional().describe('Default task subject'),
dueDate: z.string().optional().describe('Default due date (ISO 8601 format)'),
dueDateFlag: z.boolean().optional().describe('Enable due date (true=enabled, false=disabled)'),
milestoneId: z.string().optional().describe('Default milestone ID'),
tagIds: z.array(z.string()).optional().describe('Default tag IDs'),
priority: z.enum(['highest', 'high', 'normal', 'low', 'lowest', 'none']).optional().describe('Default priority'),
isDefault: z.boolean().optional().describe('Set as default template for this project'),
});
export type CreateProjectTemplateInput = z.infer<typeof createProjectTemplateSchema>;
function transformUserAssignments(
users?: Array<{ type: 'member' | 'emailUser'; organizationMemberId?: string; emailAddress?: string; name?: string }>
) {
if (!users) return undefined;
return users.map(user => {
if (user.type === 'member') {
return {
type: 'member' as const,
member: { organizationMemberId: user.organizationMemberId! },
};
} else {
return {
type: 'emailUser' as const,
emailUser: { emailAddress: user.emailAddress!, name: user.name || '' },
};
}
});
}
export async function createProjectTemplateHandler(args: CreateProjectTemplateInput) {
try {
const result = await projectsApi.createProjectTemplate({
projectId: args.projectId,
templateName: args.templateName,
users: args.users ? {
to: transformUserAssignments(args.users.to),
cc: transformUserAssignments(args.users.cc),
} : undefined,
body: args.body,
guide: args.guide,
subject: args.subject,
dueDate: args.dueDate,
dueDateFlag: args.dueDateFlag,
milestoneId: args.milestoneId,
tagIds: args.tagIds,
priority: args.priority,
isDefault: args.isDefault,
});
return {
content: [
{
type: 'text',
text: JSON.stringify({
id: result.id,
message: 'Template created successfully',
}, null, 2),
},
],
};
} catch (error) {
return {
content: [
{
type: 'text',
text: `Error: ${formatError(error)}`,
},
],
isError: true,
};
}
}
export const createProjectTemplateTool = {
name: 'create-project-template',
description: `Create a new task template in a Dooray project.
Templates are pre-created task structures that help users quickly create tasks with predefined content.
**Required Field**:
- templateName: The name of the template
**Optional Fields**:
- users: Default assignees (to) and CC recipients
- body: Default task body content (markdown or HTML)
- guide: Instructions shown when creating tasks from this template
- subject: Default task subject/title
- dueDate: Default due date (ISO 8601 format)
- dueDateFlag: Whether due date is enabled
- milestoneId: Default milestone
- tagIds: Default tags
- priority: Default priority (highest, high, normal, low, lowest, none)
- isDefault: Set as default template (auto-fills when creating new tasks)
**Due Date Flags**:
- dueDateFlag: false → No schedule
- dueDateFlag: true, dueDate: null → Schedule exists but date is TBD
- dueDateFlag: true, dueDate: "2024-01-15T12:00:00+09:00" → Schedule with specific date
**Examples**:
- Simple template: {"projectId": "123", "templateName": "Bug Report"}
- With body: {"projectId": "123", "templateName": "Feature Request", "body": {"mimeType": "text/x-markdown", "content": "## Description\\n\\n## Expected Behavior\\n\\n## Steps to Reproduce"}}
- With defaults: {"projectId": "123", "templateName": "Sprint Task", "priority": "normal", "tagIds": ["tag1"], "isDefault": true}
Returns the created template ID.`,
inputSchema: {
type: 'object',
properties: {
projectId: {
type: 'string',
description: 'Project ID where the template will be created',
},
templateName: {
type: 'string',
description: 'Template name (required)',
},
users: {
type: 'object',
properties: {
to: {
type: 'array',
items: {
type: 'object',
properties: {
type: { type: 'string', enum: ['member', 'emailUser'] },
organizationMemberId: { type: 'string' },
emailAddress: { type: 'string' },
name: { type: 'string' },
},
required: ['type'],
},
description: 'Default assignees',
},
cc: {
type: 'array',
items: {
type: 'object',
properties: {
type: { type: 'string', enum: ['member', 'emailUser'] },
organizationMemberId: { type: 'string' },
emailAddress: { type: 'string' },
name: { type: 'string' },
},
required: ['type'],
},
description: 'Default CC recipients',
},
},
description: 'Default users for tasks created from this template',
},
body: {
type: 'object',
properties: {
mimeType: { type: 'string', enum: ['text/x-markdown', 'text/html'] },
content: { type: 'string' },
},
required: ['mimeType', 'content'],
description: 'Default task body content',
},
guide: {
type: 'object',
properties: {
mimeType: { type: 'string', enum: ['text/x-markdown', 'text/html'] },
content: { type: 'string' },
},
required: ['mimeType', 'content'],
description: 'Guide content shown when creating tasks',
},
subject: {
type: 'string',
description: 'Default task subject',
},
dueDate: {
type: 'string',
description: 'Default due date (ISO 8601 format)',
},
dueDateFlag: {
type: 'boolean',
description: 'Enable due date',
},
milestoneId: {
type: 'string',
description: 'Default milestone ID',
},
tagIds: {
type: 'array',
items: { type: 'string' },
description: 'Default tag IDs',
},
priority: {
type: 'string',
enum: ['highest', 'high', 'normal', 'low', 'lowest', 'none'],
description: 'Default priority',
},
isDefault: {
type: 'boolean',
description: 'Set as default template for this project',
},
},
required: ['projectId', 'templateName'],
},
};
