kb_list_forms

Instructions

Implementation Reference

• src/index.ts:856-875 (handler)

  The main handler logic for executing the kb_list_forms tool. It extracts the 'type' parameter and returns the appropriate forms (onboarding, quick, or both) as JSON.

  case 'kb_list_forms': {
    const type = (args as any).type || 'all';
    let forms: any = {};
    
    if (type === 'onboarding' || type === 'all') {
      forms.onboarding = onboardingForms;
    }
    if (type === 'quick' || type === 'all') {
      forms.quick = quickForms;
    }
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(forms, null, 2)
        }
      ]
    };
  }

• src/index.ts:324-337 (registration)

  Registration of the kb_list_forms tool in the MCP tools list, including its description and input schema.

  {
    name: 'kb_list_forms',
    description: 'List available forms and their structures',
    inputSchema: {
      type: 'object',
      properties: {
        type: {
          type: 'string',
          enum: ['onboarding', 'quick', 'all'],
          default: 'all'
        }
      }
    }
  },

• src/forms.ts:3-143 (helper)

  Definition of onboardingForms, which contains structured question data for onboarding categories. Used by kb_list_forms.

  export const onboardingForms: Record<string, OnboardingQuestion[]> = {
    initial: [
      {
        id: 'personal_name',
        question: 'What is your full name?',
        category: 'personal',
        field: 'name',
        type: 'text',
        required: true
      },
      {
        id: 'personal_birth_year',
        question: 'What year were you born?',
        category: 'personal',
        field: 'birthYear',
        type: 'number',
        required: false
      },
      {
        id: 'personal_location',
        question: 'Where are you currently located? (City, Country)',
        category: 'personal',
        field: 'currentLocation',
        type: 'text',
        required: false
      },
      {
        id: 'personal_languages',
        question: 'What languages do you speak? (comma-separated)',
        category: 'personal',
        field: 'languages',
        type: 'multiselect',
        required: false
      },
      {
        id: 'personal_pronouns',
        question: 'What are your pronouns?',
        category: 'personal',
        field: 'pronouns',
        type: 'text',
        required: false
      }
    ],
    professional: [
      {
        id: 'prof_occupation',
        question: 'What is your occupation/job title?',
        category: 'professional',
        field: 'occupation',
        type: 'text',
        required: true
      },
      {
        id: 'prof_experience',
        question: 'How many years of experience do you have?',
        category: 'professional',
        field: 'yearsOfExperience',
        type: 'number',
        required: false
      },
      {
        id: 'prof_industry',
        question: 'What industry do you work in?',
        category: 'professional',
        field: 'industry',
        type: 'text',
        required: false
      },
      {
        id: 'prof_specializations',
        question: 'What are your specializations? (comma-separated)',
        category: 'professional',
        field: 'specializations',
        type: 'multiselect',
        required: false
      },
      {
        id: 'prof_skills',
        question: 'What are your main technical skills? (comma-separated)',
        category: 'professional',
        field: 'skills',
        type: 'multiselect',
        required: false
      }
    ],
    preferences: [
      {
        id: 'pref_communication',
        question: 'How do you prefer communication? (formal/casual/technical)',
        category: 'preferences',
        field: 'communicationStyle',
        type: 'select',
        options: ['formal', 'casual', 'technical', 'balanced'],
        required: false
      },
      {
        id: 'pref_detail',
        question: 'How detailed should responses be?',
        category: 'preferences',
        field: 'responseDetail',
        type: 'select',
        options: ['concise', 'detailed', 'balanced'],
        required: false
      },
      {
        id: 'pref_technical',
        question: 'What is your technical expertise level?',
        category: 'preferences',
        field: 'technicalLevel',
        type: 'select',
        options: ['beginner', 'intermediate', 'expert'],
        required: false
      }
    ],
    projects: [
      {
        id: 'proj_current',
        question: 'What projects are you currently working on? (comma-separated)',
        category: 'projects',
        field: 'currentProjects',
        type: 'multiselect',
        required: false
      },
      {
        id: 'proj_tech',
        question: 'What technologies are you using? (comma-separated)',
        category: 'projects',
        field: 'technologies',
        type: 'multiselect',
        required: false
      },
      {
        id: 'proj_goals',
        question: 'What are your current goals? (comma-separated)',
        category: 'projects',
        field: 'goals',
        type: 'multiselect',
        required: false
      }
    ]
  };

• src/forms.ts:145-173 (helper)

  Definition of quickForms, which contains field structures for quick setup forms. Used by kb_list_forms.

  export const quickForms: Record<string, any> = {
    identity: {
      title: "Quick Identity Setup",
      fields: {
        name: { type: 'text', label: 'Full Name', required: true },
        occupation: { type: 'text', label: 'Job Title', required: true },
        location: { type: 'text', label: 'Location', required: false },
        languages: { type: 'array', label: 'Languages', required: false }
      }
    },
    technical: {
      title: "Technical Profile",
      fields: {
        role: { type: 'text', label: 'Role', required: true },
        experience: { type: 'number', label: 'Years of Experience', required: true },
        skills: { type: 'array', label: 'Skills', required: true },
        tools: { type: 'array', label: 'Favorite Tools', required: false }
      }
    },
    organization: {
      title: "Organization Setup",
      fields: {
        orgName: { type: 'text', label: 'Organization Name', required: true },
        industry: { type: 'text', label: 'Industry', required: true },
        size: { type: 'select', label: 'Company Size', options: ['1-10', '11-50', '51-200', '200+'], required: false },
        mission: { type: 'text', label: 'Mission', required: false }
      }
    }
  };